Set-AzConsumptionBudget

Modul:: Az.Billing Module

Uppdatera en budget i antingen en prenumeration eller en resursgrupp.

Syntax

Subscription (Standard)

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

Cmdleten Set-AzConsumptionBudget uppdaterar en budget i antingen en prenumeration eller en resursgrupp.

Exempel

Exempel 1: Uppdatera en budget med ett nytt belopp med ett budgetnamn på prenumerationsnivå

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

Exempel 2: Uppdatera en budget med ett meddelande när kostnaden eller användningen når ett tröskelvärde på 90 procent av beloppet på prenumerationsnivå

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

Exempel 3: Uppdatera en budget med ett nytt belopp med ett budgetnamn på resursgruppsnivå

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

Parametrar

-Amount

Belopp för en budget.

Parameteregenskaper

Typ:	Nullable<T>[Decimal]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Category

Budgetkategorin kan vara kostnad eller användning.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Godkända värden:	Cost, Usage
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	jfr

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ContactEmail

E-postadresser för att skicka budgetmeddelandet till när tröskelvärdet överskrids.

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

Piping and Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ContactGroup

Åtgärdsgrupper som ska skicka budgetmeddelandet till när tröskelvärdet överskrids.

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

Piping and Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ContactRole

Kontakta roller för att skicka budgetmeddelandet till när tröskelvärdet överskrids.

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Godkända värden:	Owner, Reader, Contributor
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

Piping and Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:	IAzureContextContainer
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-EndDate

Slutdatum (YÅÅÅ –MM-DD i UTC) för en budget.

Parameteregenskaper

Typ:	Nullable<T>[DateTime]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-InputObject

Budgetobjekt.

Parameteregenskaper

Typ:	PSBudget
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Piping

Position:	Named
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

Piping and Notification

Position:	Named
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-MeterFilter

Kommaavgränsad lista över mätare att filtrera på. Krävs om kategorin är användning.

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Name

Namnet på en budget.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Subscription

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

Notification

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-NotificationEnabled

Meddelandet är aktiverat. Om det inte anges inaktiveras meddelandet som standard.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

Piping and Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-NotificationKey

Nyckeln för ett meddelande som är associerat med en budget, som krävs för att skapa ett meddelande med meddelandeaktiverad växel, meddelandetröskel, kontaktmeddelanden, kontaktgrupper eller kontaktroller.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

Piping and Notification

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-NotificationThreshold

Tröskelvärde som är associerat med ett meddelande. Meddelandet skickas när kostnaden eller användningen överskred tröskelvärdet. Det är alltid procent och måste vara mellan 0 och 1000.

Parameteregenskaper

Typ:	Nullable<T>[Decimal]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

Piping and Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ResourceFilter

Kommaavgränsad lista över resursinstanser att filtrera på.

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ResourceGroupFilter

Kommaavgränsad lista över resursgrupper att filtrera på.

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ResourceGroupName

Resursgrupp för en budget.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

Subscription

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

Notification

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-StartDate

Startdatum (YÅÅÅ –MM-DD i UTC) för en budget. Inte före aktuell månad för månatlig tidsintervall. Inte före tre månader för kvartalsvis tidsintervall. Inte före tolv månader för årlig tidsintervall. Framtida startdatum högst tre månader.

Parameteregenskaper

Typ:	Nullable<T>[DateTime]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-TimeGrain

Tidsintervallet för budgeten kan vara månadsvis, kvartalsvis eller årligen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Godkända värden:	Monthly, Quarterly, Annually
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	Wi

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSBudget

Utdata

PSBudget

Kommentarer

För närvarande är PowerShell SDK för förbrukning endast tillgängligt för Enterprise-avtalskunder.
PowerShell SDK för förbrukning använder en äldre version av budget-API:et och få bakåtkompatibla objekt som att lista budgetar med filter fungerar inte som förväntat.