New-AzConsumptionBudget

  • Referens
Modul:
Az.Billing

Skapa en budget i antingen en prenumeration eller en resursgrupp.

Anteckning

Det här är den tidigare versionen av vår dokumentation. Se den senaste versionen för uppdaterad information.

Syntax

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

Description

Cmdleten New-AzConsumptionBudget skapar en budget i antingen en prenumeration eller en resursgrupp.

Exempel

Exempel 1: Skapa en kostnadsbudget med ett budgetnamn på prenumerationsnivå

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

Exempel 2: Skapa en kostnadsbudget med ett budgetnamn på resursgruppsnivå

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

Parametrar

-Amount

Belopp för en budget.

Type:Decimal
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Category

Budgetkategorin kan vara kostnad eller användning.

Type:String
Accepted values:Cost, Usage
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ContactEmail

Email adresser som budgetmeddelandet ska skickas till när tröskelvärdet överskrids.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ContactGroup

Åtgärdsgrupper som budgetmeddelandet ska skickas till när tröskelvärdet överskrids.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ContactRole

Kontakta roller för att skicka budgetmeddelandet till när tröskelvärdet överskrids.

Type:String[]
Accepted values:Owner, Reader, Contributor
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile

Autentiseringsuppgifterna, kontot, klientorganisationen och prenumerationen som används för kommunikation med Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EndDate

Slutdatum (ÅÅÅÅ-MM-DD i UTC) för en budget.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MeterFilter

Kommaavgränsad lista över mätare att filtrera på. Krävs om kategorin är användning.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Namnet på en budget.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NotificationEnabled

Meddelandet är aktiverat eller inte.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NotificationKey

Nyckeln för ett meddelande som är kopplat till en budget, krävs för att skapa ett meddelande med meddelandeaktiverad växel, meddelandetröskel, kontakt-e-post, kontaktgrupper eller kontaktroller.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NotificationThreshold

Tröskelvärde som är associerat med ett meddelande. Ett meddelande skickas när kostnaden eller användningen överskrider tröskelvärdet. Den är alltid procent och måste vara mellan 0 och 1 000.

Type:Nullable<T>[Decimal]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ResourceFilter

Kommaavgränsad lista över resursinstanser att filtrera på.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ResourceGroupFilter

Kommaavgränsad lista över resursgrupper att filtrera på.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ResourceGroupName

Resursgrupp för en budget.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StartDate

Startdatum (ÅÅÅÅ-MM-DD i UTC) för en budget. Inte före aktuell månad för månatlig tidsintervall. Inte före tre månader för kvartalsvis tidsintervall. Inte före tolv månader för årlig tidsintervall. Framtida startdatum inte mer än tre månader.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TimeGrain

Tidsintervallet för budgeten kan vara månadsvis, kvartalsvis eller årligen.

Type:String
Accepted values:Monthly, Quarterly, Annually
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Indata

None

Utdata

PSBudget

Kommentarer

  • För närvarande är PowerShell SDK för förbrukning endast tillgängligt för Enterprise-avtal kunder.
  • PowerShell SDK för förbrukning använder en äldre version av Budgets API och få bakåtkompatibla objekt som att lista budgetar med filter fungerar inte som förväntat.