New-AzConsumptionBudget

Modul:: Az.Billing Module

Skapa en budget i antingen en prenumeration eller en resursgrupp.

Syntax

Subscription (Standard)

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

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.

Parameteregenskaper

Typ:	Decimal
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Category

Budgetkategorin kan vara kostnad eller användning.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Godkända värden:	Cost, Usage
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Confirm

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

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	jfr

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ContactEmail

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

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ContactGroup

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

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ContactRole

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

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Godkända värden:	Owner, Reader, Contributor
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-DefaultProfile

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

Parameteregenskaper

Typ:	IAzureContextContainer
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-EndDate

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

Parameteregenskaper

Typ:	Nullable<T>[DateTime]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-MeterFilter

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

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Name

Namnet på en budget.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-NotificationEnabled

Meddelandet är aktiverat eller inte.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	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.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	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.

Parameteregenskaper

Typ:	Nullable<T>[Decimal]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ResourceFilter

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

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ResourceGroupFilter

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

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ResourceGroupName

Resursgrupp för en budget.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	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.

Parameteregenskaper

Typ:	Nullable<T>[DateTime]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-TimeGrain

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

Parameteregenskaper

Typ:	String
Standardvärde:	None
Godkända värden:	Monthly, Quarterly, Annually
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-WhatIf

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

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	Wi

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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.

Feedback

Var den här sidan till hjälp?