New-AzConsumptionBudget

Riferimento

Modulo:: Az.Billing

Creare un budget in una sottoscrizione o in un gruppo di risorse.

Sintassi

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>]

Descrizione

Il cmdlet New-AzConsumptionBudget crea un budget in una sottoscrizione o in un gruppo di risorse.

Esempio

Esempio 1: Creare un budget di costo con un nome di budget a livello di sottoscrizione

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

Esempio 2: Creare un budget di costo con un nome di budget a livello di gruppo di risorse

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

Parametri

-Amount

Importo di un budget.

Type:	Decimal
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Category

La categoria del budget può essere un costo o un utilizzo.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-ContactEmail

Indirizzi di posta elettronica a cui inviare la notifica del budget quando viene superata la soglia.

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

-ContactGroup

Gruppi di azioni a cui inviare la notifica del budget quando viene superata la soglia.

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

-ContactRole

Contattare i ruoli per inviare la notifica del budget a quando viene superata la soglia.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-EndDate

Data di fine (AAAA-MM-GG in formato UTC) del periodo di tempo di un budget.

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

-MeterFilter

Elenco delimitato da virgole di contatori da filtrare. Obbligatorio se la categoria è in uso.

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

-Name

Nome di un budget.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NotificationEnabled

La notifica è abilitata o meno.

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

-NotificationKey

Chiave di una notifica associata a un budget, necessaria per creare una notifica con cambio abilitato per le notifiche, soglia di notifica, messaggi di posta elettronica di contatto, gruppi di contatti o ruoli di contatto.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NotificationThreshold

Valore soglia associato a una notifica. La notifica viene inviata quando il costo o l'utilizzo supera la soglia. È sempre la percentuale e deve essere compresa tra 0 e 1000.

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

-ResourceFilter

Elenco delimitato da virgole di istanze di risorse da filtrare.

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

-ResourceGroupFilter

Elenco delimitato da virgole di gruppi di risorse da filtrare.

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

-ResourceGroupName

Gruppo di risorse di un budget.

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

-StartDate

Data di inizio (AAAA-MM-GG in formato UTC) del periodo di tempo di un budget. Non prima del mese corrente per l'intervallo di tempo mensile. Non prima di tre mesi per l'intervallo di tempo trimestrale. Non prima di dodici mesi per il grano di tempo annuale. Data di inizio futura non più di tre mesi.

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

-TimeGrain

L'intervallo di tempo del budget può essere mensile, trimestrale o annuale.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

None

Output

PSBudget

Note

Attualmente, PowerShell SDK per il consumo è disponibile solo per Contratto Enterprise clienti.
PowerShell SDK per il consumo usa una versione precedente dell'API Budget e alcuni elementi non compatibili, ad esempio l'elenco di budget con filtri, non funzioneranno come previsto.

Share via