Set-AzConsumptionBudget

Module:: Az.Billing Module

Mettez à jour un budget dans un abonnement ou un groupe de ressources.

Syntaxe

Subscription (Par défaut)

Set-AzConsumptionBudget
    -Name <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-Amount <Decimal>]
    [-Category <String>]
    [-TimeGrain <String>]
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-ResourceGroupName <String>]
    [-MeterFilter <String[]>]
    [-ResourceFilter <String[]>]
    [-ResourceGroupFilter <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Notification

Set-AzConsumptionBudget
    -Name <String>
    -NotificationKey <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-Amount <Decimal>]
    [-Category <String>]
    [-TimeGrain <String>]
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-ResourceGroupName <String>]
    [-MeterFilter <String[]>]
    [-ResourceFilter <String[]>]
    [-ResourceGroupFilter <String[]>]
    [-NotificationEnabled]
    [-NotificationThreshold <Decimal>]
    [-ContactEmail <String[]>]
    [-ContactGroup <String[]>]
    [-ContactRole <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Piping

Set-AzConsumptionBudget
    -InputObject <PSBudget>
    [-DefaultProfile <IAzureContextContainer>]
    [-Amount <Decimal>]
    [-Category <String>]
    [-TimeGrain <String>]
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-MeterFilter <String[]>]
    [-ResourceFilter <String[]>]
    [-ResourceGroupFilter <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Piping and Notification

Set-AzConsumptionBudget
    -InputObject <PSBudget>
    -NotificationKey <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-Amount <Decimal>]
    [-Category <String>]
    [-TimeGrain <String>]
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-MeterFilter <String[]>]
    [-ResourceFilter <String[]>]
    [-ResourceGroupFilter <String[]>]
    [-NotificationEnabled]
    [-NotificationThreshold <Decimal>]
    [-ContactEmail <String[]>]
    [-ContactGroup <String[]>]
    [-ContactRole <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Set-AzConsumptionBudget met à jour un budget dans un abonnement ou un groupe de ressources.

Exemples

Exemple 1 : Mettre à jour un budget d’un nouveau montant avec un nom de budget au niveau de l’abonnement

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/budgets

Exemple 2 : Mettre à jour un budget avec une notification lorsque le coût ou l’utilisation atteint un seuil de 90 % du montant au niveau de l’abonnement

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/budgets

Exemple 3 : Mettre à jour un budget d’un nouveau montant avec un nom de budget au niveau du groupe de ressources

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/budgets

Paramètres

-Amount

Montant d’un budget.

Propriétés du paramètre

Type:	Nullable<T>[Decimal]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Category

La catégorie du budget peut être un coût ou une utilisation.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	Cost, Usage
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ContactEmail

Adresses e-mail à laquelle envoyer la notification budgétaire lorsque le seuil est dépassé.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Notification

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Piping and Notification

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ContactGroup

Groupes d’actions auxquels envoyer la notification budgétaire lorsque le seuil est dépassé.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Notification

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Piping and Notification

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ContactRole

Contactez les rôles pour envoyer la notification budgétaire au moment où le seuil est dépassé.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Valeurs acceptées:	Owner, Reader, Contributor
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Notification

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Piping and Notification

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:	IAzureContextContainer
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-EndDate

Date de fin (AAAA-MM-DD utc) de la période d’un budget.

Propriétés du paramètre

Type:	Nullable<T>[DateTime]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-InputObject

Objet Budget.

Propriétés du paramètre

Type:	PSBudget
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Piping

Position:	Named
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Piping and Notification

Position:	Named
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-MeterFilter

Liste séparée par des virgules de compteurs à filtrer. Obligatoire si la catégorie est utilisée.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Name

Nom d’un budget.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Subscription

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Notification

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-NotificationEnabled

La notification est activée. Si elle n’est pas spécifiée, la notification est désactivée par défaut.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Notification

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Piping and Notification

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-NotificationKey

Clé d’une notification associée à un budget, nécessaire pour créer une notification avec un commutateur activé, un seuil de notification, des e-mails de contact, des groupes de contacts ou des rôles de contact activés.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Notification

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Piping and Notification

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-NotificationThreshold

Valeur de seuil associée à une notification. La notification est envoyée lorsque le coût ou l’utilisation dépasse le seuil. Il est toujours pourcentage et doit être compris entre 0 et 1000.

Propriétés du paramètre

Type:	Nullable<T>[Decimal]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Notification

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Piping and Notification

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ResourceFilter

Liste séparée par des virgules des instances de ressources à filtrer.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ResourceGroupFilter

Liste séparée par des virgules de groupes de ressources à filtrer.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ResourceGroupName

Groupe de ressources d’un budget.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Subscription

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Notification

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-StartDate

Date de début (AAAA-MM-DD en UTC) de la période d’un budget. Pas avant le mois en cours pour le grain de temps mensuel. Pas avant trois mois pour le grain de temps trimestriel. Pas avant douze mois pour le grain de temps annuel. Date de début future pas plus de trois mois.

Propriétés du paramètre

Type:	Nullable<T>[DateTime]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-TimeGrain

Le grain de temps du budget peut être mensuel, trimestriel ou annuel.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	Monthly, Quarterly, Annually
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSBudget

Sorties

PSBudget

Notes

Actuellement, le Kit de développement logiciel (SDK) PowerShell pour la consommation est disponible uniquement pour les clients contrat Entreprise.
Le Kit de développement logiciel (SDK) PowerShell pour la consommation utilise une version antérieure de l’API Budgets et peu d’éléments rétrocompatibles, tels que la description des budgets avec des filtres, ne fonctionne pas comme prévu.

Commentaires

Cette page a-t-elle été utile ?