New-AzConsumptionBudget

Maak een budget in een abonnement of een resourcegroep.

Syntax

Subscription (Standaard)

New-AzConsumptionBudget
    -Name <String>
    -Amount <Decimal>
    -Category <String>
    -TimeGrain <String>
    -StartDate <DateTime>
    [-DefaultProfile <IAzureContextContainer>]
    [-EndDate <DateTime>]
    [-ResourceGroupName <String>]
    [-MeterFilter <String[]>]
    [-ResourceFilter <String[]>]
    [-ResourceGroupFilter <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Notification

New-AzConsumptionBudget
    -Name <String>
    -Amount <Decimal>
    -Category <String>
    -TimeGrain <String>
    -StartDate <DateTime>
    -NotificationKey <String>
    -NotificationThreshold <Decimal>
    -ContactEmail <String[]>
    [-DefaultProfile <IAzureContextContainer>]
    [-EndDate <DateTime>]
    [-ResourceGroupName <String>]
    [-MeterFilter <String[]>]
    [-ResourceFilter <String[]>]
    [-ResourceGroupFilter <String[]>]
    [-NotificationEnabled]
    [-ContactGroup <String[]>]
    [-ContactRole <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

De New-AzConsumptionBudget cmdlet maakt een budget in een abonnement of een resourcegroep.

Voorbeelden

Voorbeeld 1: Een kostenbudget maken met een budgetnaam op abonnementsniveau

New-AzConsumptionBudget -Amount 60 -Name PSBudget -Category Cost -StartDate 2018-06-01 -EndDate 2018-11-01 -TimeGrain Monthly
Amount:  60
Category:  Cost
CurrentSpend:  null
Id:  subscriptions/1caaa5a3-2b66-438e-8ab4-bce37d518c5d/providers/Microsoft.Consumption/budgets/PSBudget
Name:  PSBudget
TimeGrain:  Monthly
TimePeriod:  EndDate:  11/1/2018 12:00:00 AM
             StartDate:  6/1/2018 12:00:00 AM
Type:  Microsoft.Consumption/budgets

Voorbeeld 2: Een kostenbudget maken met een budgetnaam op resourcegroepsniveau

New-AzConsumptionBudget -ResourceGroupName RGBudgets -Amount 60 -Name PSBudgetRG -Category Cost -StartDate 2018-06-01 -EndDate 2018-11-01 -TimeGrain Monthly
Amount:  60
Category:  Cost
CurrentSpend:  null
Id:  subscriptions/1caaa5a3-2b66-438e-8ab4-bce37d518c5d/resourceGroups/RGBudgets/providers/Microsoft.Consumption/budgets/PSBudgetRG
Name:  PSBudgetRG
TimeGrain:  Monthly
TimePeriod:  EndDate:  11/1/2018 12:00:00 AM
             StartDate:  6/1/2018 12:00:00 AM
Type:  Microsoft.Consumption/budgets

Parameters

-Amount

Bedrag van een budget.

Parametereigenschappen

Type:Decimal
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Category

Categorie van het budget kan kosten of gebruik zijn.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Cost, Usage
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ContactEmail

E-mailadressen voor het verzenden van de budgetmelding naar wanneer de drempelwaarde wordt overschreden.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Notification
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ContactGroup

Actiegroepen om de budgetmelding te verzenden wanneer de drempelwaarde wordt overschreden.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Notification
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ContactRole

Neem contact op met rollen om de budgetmelding te verzenden wanneer de drempelwaarde wordt overschreden.

Parametereigenschappen

Type:

String[]

Default value:None
Geaccepteerde waarden:Owner, Reader, Contributor
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Notification
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-EndDate

Einddatum (JJJJ-MM-DD in UTC) van een periode van een budget.

Parametereigenschappen

Type:

Nullable<T>[DateTime]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-MeterFilter

Door komma's gescheiden lijst met meters waarop moet worden gefilterd. Vereist als de categorie het gebruik is.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

Naam van een budget.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-NotificationEnabled

De melding is ingeschakeld of niet.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Notification
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-NotificationKey

Sleutel van een melding die is gekoppeld aan een budget, vereist voor het maken van een melding met schakeloptie voor meldingen, drempelwaarde voor meldingen, e-mailberichten met contactpersonen, groepen contactpersonen of rollen voor contactpersonen.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Notification
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-NotificationThreshold

Drempelwaarde die is gekoppeld aan een melding. Er wordt een melding verzonden wanneer de kosten of het gebruik de drempelwaarde hebben overschreden. Het is altijd procent en moet tussen 0 en 1000 zijn.

Parametereigenschappen

Type:

Nullable<T>[Decimal]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Notification
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceFilter

Door komma's gescheiden lijst met resource-exemplaren waarop u wilt filteren.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceGroupFilter

Door komma's gescheiden lijst met resourcegroepen waarop u wilt filteren.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceGroupName

Resourcegroep van een budget.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-StartDate

Begindatum (JJJJ-MM-DD in UTC) van een periode van een budget. Niet vóór de huidige maand voor maandelijkse tijdsinterval. Niet vóór drie maanden voor kwartaalinterval. Niet vóór twaalf maanden voor jaarlijkse tijdsinterval. Toekomstige begindatum niet meer dan drie maanden.

Parametereigenschappen

Type:

Nullable<T>[DateTime]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-TimeGrain

Tijdsinterval van het budget kan maandelijks, kwartaal of jaarlijks zijn.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Monthly, Quarterly, Annually
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

Uitvoerwaarden

PSBudget

Notities

  • PowerShell SDK voor verbruik is momenteel alleen beschikbaar voor Enterprise Agreement-klanten.
  • PowerShell SDK voor verbruik maakt gebruik van een oudere versie van budgetten-API en weinig achterwaarts niet-compatibele items, zoals budgetten met filters, werken niet zoals verwacht.