New-AzConsumptionBudget

Module:: Az.Billing Module

Créez un budget dans un abonnement ou un groupe de ressources.

Syntaxe

Subscription (Par défaut)

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

L’applet de commande New-AzConsumptionBudget crée un budget dans un abonnement ou un groupe de ressources.

Exemples

Exemple 1 : Créer un budget de coût avec un nom de budget au niveau de l’abonnement

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

Exemple 2 : Créer un budget de coût avec un nom de budget au niveau du groupe de ressources

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

Paramètres

-Amount

Montant d’un budget.

Propriétés du paramètre

Type:	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:	True
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:	True
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:	True
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

-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

-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

-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

(All)

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 ou non.

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

-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

-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:	True
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

(All)

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:	True
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:	True
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

None

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 ?