Set-AzConsumptionBudget

Referentie

Module:: Az.Billing

Een budget bijwerken in een abonnement of een resourcegroep.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

Syntax

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

Description

Met de Set-AzConsumptionBudget cmdlet wordt een budget bijgewerkt in een abonnement of een resourcegroep.

Voorbeelden

Voorbeeld 1: Een budget bijwerken op een nieuw bedrag met een budgetnaam op abonnementsniveau

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

Voorbeeld 2: Een budget bijwerken met een melding wanneer de kosten of het gebruik een drempelwaarde van 90 procent van het bedrag bereiken op abonnementsniveau

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

Voorbeeld 3: Een budget bijwerken met een nieuw bedrag met een budgetnaam op resourcegroepsniveau

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

Parameters

-Amount

Bedrag van een budget.

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

-Category

Categorie van het budget kan kosten of gebruik zijn.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-ContactEmail

Email adressen om de budgetmelding te verzenden naar wanneer de drempelwaarde wordt overschreden.

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

-ContactGroup

Actiegroepen voor het verzenden van de budgetmelding naar wanneer de drempelwaarde wordt overschreden.

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

-ContactRole

Contactrollen voor het verzenden van de budgetmelding naar wanneer de drempelwaarde wordt overschreden.

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure.

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

-EndDate

Einddatum (JJJJ-MM-DD in UTC) van de periode van een budget.

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

-InputObject

Budgetobject.

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

-MeterFilter

Door komma's gescheiden lijst met meters waarop moet worden gefilterd. Vereist als categorie gebruik is.

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

-Name

Naam van een budget.

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

-NotificationEnabled

De melding is ingeschakeld. Als deze niet is opgegeven, wordt de melding standaard uitgeschakeld.

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

-NotificationKey

Sleutel van een melding die is gekoppeld aan een budget, vereist voor het maken van een melding met schakeloptie voor meldingen, drempelwaarde voor meldingen, e-mails met contactpersonen, groepen contactpersonen of rollen van contactpersonen.

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

-NotificationThreshold

Drempelwaarde die is gekoppeld aan een melding. Er wordt een melding verzonden wanneer de kosten of het gebruik de drempelwaarde hebben overschreden. Het is altijd procent en moet tussen 0 en 1000 zijn.

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

-ResourceFilter

Door komma's gescheiden lijst met resource-exemplaren waarop u wilt filteren.

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

-ResourceGroupFilter

Door komma's gescheiden lijst met resourcegroepen waarop u wilt filteren.

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

-ResourceGroupName

Resourcegroep van een budget.

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

-StartDate

Begindatum (JJJJ-MM-DD in UTC) van de periode van een budget. Niet vóór de huidige maand voor maandelijkse tijdsinterval. Niet vóór drie maanden voor kwartaalinterval. Niet vóór twaalf maanden voor jaarlijkse tijdsinterval. Toekomstige begindatum niet meer dan drie maanden.

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

-TimeGrain

Tijdsinterval van het budget kan maandelijks, kwartaal of jaarlijks zijn.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

PSBudget

Uitvoerwaarden

PSBudget

Notities

PowerShell SDK voor verbruik is momenteel alleen beschikbaar voor Enterprise Agreement klanten.
PowerShell SDK voor Verbruik maakt gebruik van een oudere versie van budgetten-API en weinig achterwaarts niet-compatibele items, zoals budgetten met filters, werken niet zoals verwacht.