New-AzConsumptionBudget

Reference

Modul:: Az.Billing

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

Syntaxe

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

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

Description

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

Příklady

Příklad 1: Vytvoření rozpočtu nákladů s názvem rozpočtu na úrovni předplatného

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

Příklad 2: Vytvoření rozpočtu nákladů s názvem rozpočtu na úrovni skupiny prostředků

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

Parametry

-Amount

Částka rozpočtu.

Typ:	Decimal
Position:	Named
Default value:	None
Vyžadováno:	True
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:	True
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:	True
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

-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é nebo není.

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

None

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í.

Sdílet prostřednictvím