New-AzConsumptionBudget

Referens

Modul:: Az.Billing

Skapa en budget i antingen en prenumeration eller en resursgrupp.

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.

Typ:	Decimal
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Category

Budgetkategorin kan vara kostnad eller användning.

Typ:	String
Godkända värden:	Cost, Usage
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Confirm

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

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ContactEmail

E-postadresser för att skicka budgetmeddelandet till när tröskelvärdet överskrids.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ContactGroup

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

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ContactRole

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

Typ:	String[]
Godkända värden:	Owner, Reader, Contributor
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-EndDate

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

Typ:	Nullable<T>[DateTime]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MeterFilter

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

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Name

Namnet på en budget.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NotificationEnabled

Meddelandet är aktiverat eller inte.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NotificationKey

Nyckeln för ett meddelande som är associerat med en budget, som krävs för att skapa ett meddelande med meddelandeaktiverad växel, meddelandetröskel, kontaktmeddelanden, kontaktgrupper eller kontaktroller.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NotificationThreshold

Tröskelvärde som är associerat med ett meddelande. Meddelandet skickas när kostnaden eller användningen överskred tröskelvärdet. Det är alltid procent och måste vara mellan 0 och 1000.

Typ:	Nullable<T>[Decimal]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceFilter

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

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceGroupFilter

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

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceGroupName

Resursgrupp för en budget.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-StartDate

Startdatum (YÅÅÅ –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 högst tre månader.

Typ:	Nullable<T>[DateTime]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-TimeGrain

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

Typ:	String
Godkända värden:	Monthly, Quarterly, Annually
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

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

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

None

Utdata

PSBudget

Kommentarer

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

Dela via