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] |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Category
La categoria del budget può essere un costo o un utilizzo.
| Tipo: | String |
| valori accettati: | Cost, Usage |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | 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.
| Tipo: | String[] |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContactGroup
Gruppi di azioni a cui inviare la notifica del budget quando viene superata la soglia.
| Tipo: | String[] |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | 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.
| Tipo: | String[] |
| valori accettati: | Owner, Reader, Contributor |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | 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.
| Tipo: | Nullable<T>[DateTime] |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Oggetto Budget.
| Tipo: | PSBudget |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MeterFilter
Elenco delimitato da virgole di contatori da filtrare. Obbligatorio se la categoria è in uso.
| Tipo: | String[] |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Nome di un budget.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NotificationEnabled
La notifica è abilitata. Se non specificato, la notifica viene disabilitata per impostazione predefinita.
| Tipo: | SwitchParameter |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | 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.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | 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.
| Tipo: | Nullable<T>[Decimal] |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceFilter
Elenco delimitato da virgole di istanze di risorse da filtrare.
| Tipo: | String[] |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupFilter
Elenco delimitato da virgole di gruppi di risorse da filtrare.
| Tipo: | String[] |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
Gruppo di risorse di un budget.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | 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.
| Tipo: | Nullable<T>[DateTime] |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeGrain
L'intervallo di tempo del budget può essere mensile, trimestrale o annuale.
| Tipo: | String |
| valori accettati: | Monthly, Quarterly, Annually |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per