Set-AzConsumptionBudget
Aggiornare un budget in una sottoscrizione o in un gruppo di risorse.
Sintassi
Set-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>] Set-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>] Set-AzConsumptionBudget
[-DefaultProfile <IAzureContextContainer>]
-InputObject <PSBudget>
[-Amount <Decimal>]
[-Category <String>]
[-TimeGrain <String>]
[-StartDate <DateTime>]
[-EndDate <DateTime>]
[-MeterFilter <String[]>]
[-ResourceFilter <String[]>]
[-ResourceGroupFilter <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzConsumptionBudget
[-DefaultProfile <IAzureContextContainer>]
-InputObject <PSBudget>
[-Amount <Decimal>]
[-Category <String>]
[-TimeGrain <String>]
[-StartDate <DateTime>]
[-EndDate <DateTime>]
[-MeterFilter <String[]>]
[-ResourceFilter <String[]>]
[-ResourceGroupFilter <String[]>]
-NotificationKey <String>
[-NotificationEnabled]
[-NotificationThreshold <Decimal>]
[-ContactEmail <String[]>]
[-ContactGroup <String[]>]
[-ContactRole <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet Set-AzConsumptionBudget aggiorna un budget in una sottoscrizione o in un gruppo di risorse.
Esempio
Esempio 1: Aggiornare un budget in base a un nuovo importo con un nome di budget a livello di sottoscrizione
Set-AzConsumptionBudget -Name PSBudget -Amount 75
Amount: 75
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/budgetsEsempio 2: Aggiornare un budget con una notifica quando il costo o l'utilizzo raggiunge una soglia del 90% dell'importo a livello di sottoscrizione
Set-AzConsumptionBudget -Name PSBudget -NotificationKey notificationKey-ps1234 -NotificationEnabled -NotificationThreshold 90 -ContactEmail @('johndoe@contoso.com','janesmith@contoso.com') -ContactRole Owner,Reader,Contributor
Amount: 75
Category: Cost
CurrentSpend: null
Id: subscriptions/1caaa5a3-2b66-438e-8ab4-bce37d518c5d/providers/Microsoft.Consumption/budgets/PSBudget
Name: PSBudget
Notification: NotificationKey: notificationKey-ps1234
Threshold: 90
Enabled: true
ContactEmail: johndoe@contoso.com,janesmith@contoso.com
ContactRole: Owner,Reader,Contributor
TimeGrain: Monthly
TimePeriod: EndDate: 11/1/2018 12:00:00 AM
StartDate: 6/1/2018 12:00:00 AM
Type: Microsoft.Consumption/budgetsEsempio 3: Aggiornare un budget in base a un nuovo importo con un nome di budget a livello di gruppo di risorse
Set-AzConsumptionBudget -ResourceGroupName RGBudgets -Name PSBudgetRG -Amount 75
Amount: 75
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/budgetsParametri
-Amount
Importo di un budget.
| Tipo: | Nullable<T>[Decimal] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Category
La categoria del budget può essere un costo o un utilizzo.
| Tipo: | String |
| Valori accettati: | Cost, Usage |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ContactEmail
Indirizzi di posta elettronica a cui inviare la notifica del budget quando viene superata la soglia.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ContactGroup
Gruppi di azioni a cui inviare la notifica del budget quando viene superata la soglia.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ContactRole
Contattare i ruoli per inviare la notifica del budget a quando viene superata la soglia.
| Tipo: | String[] |
| Valori accettati: | Owner, Reader, Contributor |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DefaultProfile
Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.
| Tipo: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-EndDate
Data di fine (AAAA-MM-GG in formato UTC) del periodo di tempo di un budget.
| Tipo: | Nullable<T>[DateTime] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-InputObject
Oggetto Budget.
| Tipo: | PSBudget |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-MeterFilter
Elenco delimitato da virgole di contatori da filtrare. Obbligatorio se la categoria è in uso.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Name
Nome di un budget.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-NotificationEnabled
La notifica è abilitata. Se non specificato, la notifica viene disabilitata per impostazione predefinita.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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.
| Tipo: | Nullable<T>[Decimal] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ResourceFilter
Elenco delimitato da virgole di istanze di risorse da filtrare.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ResourceGroupFilter
Elenco delimitato da virgole di gruppi di risorse da filtrare.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ResourceGroupName
Gruppo di risorse di un budget.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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.
| Tipo: | Nullable<T>[DateTime] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-TimeGrain
L'intervallo di tempo del budget può essere mensile, trimestrale o annuale.
| Tipo: | String |
| Valori accettati: | Monthly, Quarterly, Annually |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
Output
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.