Set-AzConsumptionBudget

Module:: Az.Billing Module

Werk een budget bij in een abonnement of een resourcegroep.

Syntax

Subscription (Standaard)

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

De Set-AzConsumptionBudget cmdlet werkt een budget bij in een abonnement of een resourcegroep.

Voorbeelden

Voorbeeld 1: Een budget bijwerken met 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 kosten of gebruik een drempelwaarde van 90 procent van het bedrag bereikt 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 op 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.

Parametereigenschappen

Type:	Nullable<T>[Decimal]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Category

Categorie van het budget kan kosten of gebruik zijn.

Parametereigenschappen

Type:	String
Default value:	None
Geaccepteerde waarden:	Cost, Usage
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Cf

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ContactEmail

E-mailadressen voor het verzenden van de budgetmelding naar wanneer de drempelwaarde wordt overschreden.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

Notification

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

Piping and Notification

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ContactGroup

Actiegroepen om de budgetmelding te verzenden wanneer de drempelwaarde wordt overschreden.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

Notification

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

Piping and Notification

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ContactRole

Neem contact op met rollen om de budgetmelding te verzenden wanneer de drempelwaarde wordt overschreden.

Parametereigenschappen

Type:	String[]
Default value:	None
Geaccepteerde waarden:	Owner, Reader, Contributor
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

Notification

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

Piping and Notification

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:	IAzureContextContainer
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	AzContext, AzureRmContext, AzureCredential

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-EndDate

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

Parametereigenschappen

Type:	Nullable<T>[DateTime]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-InputObject

Budgetobject.

Parametereigenschappen

Type:	PSBudget
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

Piping

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	True
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

Piping and Notification

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	True
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-MeterFilter

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

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Name

Naam van een budget.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

Subscription

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

Notification

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-NotificationEnabled

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

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

Notification

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

Piping and Notification

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	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-mailberichten met contactpersonen, groepen contactpersonen of rollen voor contactpersonen.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

Notification

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

Piping and Notification

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	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.

Parametereigenschappen

Type:	Nullable<T>[Decimal]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

Notification

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

Piping and Notification

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ResourceFilter

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

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ResourceGroupFilter

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

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ResourceGroupName

Resourcegroep van een budget.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

Subscription

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

Notification

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-StartDate

Begindatum (JJJJ-MM-DD in UTC) van een 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.

Parametereigenschappen

Type:	Nullable<T>[DateTime]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-TimeGrain

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

Parametereigenschappen

Type:	String
Default value:	None
Geaccepteerde waarden:	Monthly, Quarterly, Annually
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Wi

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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.

Feedback

Is deze pagina nuttig?