Sdílet prostřednictvím


Set-AzConsumptionBudget

Aktualizujte rozpočet v předplatném nebo ve skupině prostředků.

Syntaxe

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

Rutina Set-AzConsumptionBudget aktualizuje rozpočet v předplatném nebo ve skupině prostředků.

Příklady

Příklad 1: Aktualizace rozpočtu o novou částku s názvem rozpočtu na úrovni předplatného

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

Příklad 2: Aktualizace rozpočtu oznámením, když náklady nebo využití dosáhnou prahové hodnoty 90 procent na úrovni předplatného

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

Příklad 3: Aktualizace rozpočtu o novou částku s názvem rozpočtu na úrovni skupiny prostředků

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

Parametry

-Amount

Částka rozpočtu.

Typ:Nullable<T>[Decimal]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Category

Kategorie rozpočtu může být náklady nebo využití.

Typ:String
Přípustné hodnoty:Cost, Usage
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ContactEmail

E-mailové adresy, na které se mají odeslat oznámení o rozpočtu při překročení prahové hodnoty.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ContactGroup

Skupiny akcí, do které se mají odeslat oznámení o rozpočtu při překročení prahové hodnoty

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ContactRole

Kontaktní role pro odeslání oznámení o rozpočtu při překročení prahové hodnoty.

Typ:String[]
Přípustné hodnoty:Owner, Reader, Contributor
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EndDate

Koncové datum (YYYY-MM-DD v UTC) časového období rozpočtu.

Typ:Nullable<T>[DateTime]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Rozpočtový objekt.

Typ:PSBudget
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-MeterFilter

Seznam měřičů oddělených čárkami, podle které se mají filtrovat. Vyžaduje se, pokud se kategorie používá.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Název rozpočtu.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NotificationEnabled

Oznámení je povolené. Pokud není zadané, oznámení je ve výchozím nastavení zakázané.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NotificationKey

Klíč oznámení přidruženého k rozpočtu, který je nutný k vytvoření oznámení s povoleným přepínačem oznámení, prahovou hodnotou oznámení, kontaktními e-maily, skupinami kontaktů nebo rolemi kontaktů.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NotificationThreshold

Prahová hodnota přidružená k oznámení Oznámení se odešle, když náklady nebo využití překročí prahovou hodnotu. Vždy je to procento a musí být mezi 0 a 1 000.

Typ:Nullable<T>[Decimal]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceFilter

Seznam instancí prostředků oddělený čárkami pro filtrování

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupFilter

Seznam skupin prostředků oddělený čárkami, podle které se mají filtrovat.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Skupina prostředků rozpočtu

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-StartDate

Počáteční datum (YYYY-MM-DD v UTC) časového období rozpočtu. Před aktuálním měsícem pro měsíční agregační interval. Před třemi měsíci na čtvrtletní interval. Ne před dvanácti měsíci pro roční interval. Budoucí počáteční datum ne více než tři měsíce.

Typ:Nullable<T>[DateTime]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TimeGrain

Časový interval rozpočtu může být měsíční, čtvrtletní nebo roční.

Typ:String
Přípustné hodnoty:Monthly, Quarterly, Annually
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSBudget

Výstupy

PSBudget

Poznámky

  • V současné době je sada PowerShell SDK pro spotřebu dostupná jenom pro zákazníky smlouva Enterprise.
  • Sada PowerShell SDK pro spotřebu používá starší verzi rozhraní API rozpočtů a několik zpětně nekompatibilních položek, jako je výpis rozpočtů s filtry, nebudou fungovat podle očekávání.