New-AzConsumptionBudget

Odwołanie

Moduł:: Az.Billing

Utwórz budżet w subskrypcji lub grupie zasobów.

Składnia

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

Opis

Polecenie cmdlet New-AzConsumptionBudget tworzy budżet w subskrypcji lub grupie zasobów.

Przykłady

Przykład 1. Tworzenie budżetu kosztów z nazwą budżetu na poziomie subskrypcji

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

Przykład 2. Tworzenie budżetu kosztów z nazwą budżetu na poziomie grupy zasobów

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

Kwota budżetu.

Typ:	Decimal
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Category

Kategoria budżetu może być kosztem lub użyciem.

Typ:	String
Dopuszczalne wartości:	Cost, Usage
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ContactEmail

Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ContactGroup

Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ContactRole

Role kontaktu w celu wysłania powiadomienia o budżecie do momentu przekroczenia progu.

Typ:	String[]
Dopuszczalne wartości:	Owner, Reader, Contributor
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-EndDate

Data zakończenia (RRRR-MM-DD w utc) okresu czasu budżetu.

Typ:	Nullable<T>[DateTime]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-MeterFilter

Rozdzielona przecinkami lista mierników do filtrowania. Wymagane, jeśli kategoria jest użyciem.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Name

Nazwa budżetu.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-NotificationEnabled

Powiadomienie jest włączone lub nie.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-NotificationKey

Klucz powiadomienia skojarzonego z budżetem wymagany do utworzenia powiadomienia z włączonym przełącznikiem powiadomień, progiem powiadomień, kontaktowymi wiadomościami e-mail, grupami kontaktów lub rolami kontaktów.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-NotificationThreshold

Wartość progowa skojarzona z powiadomieniem. Powiadomienie jest wysyłane, gdy koszt lub użycie przekroczyło próg. Zawsze jest to procent i musi należeć do przedziału od 0 do 1000.

Typ:	Nullable<T>[Decimal]
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ResourceFilter

Rozdzielona przecinkami lista wystąpień zasobów do filtrowania.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ResourceGroupFilter

Rozdzielona przecinkami lista grup zasobów do filtrowania.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ResourceGroupName

Grupa zasobów budżetu.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-StartDate

Data rozpoczęcia (RRRR-MM-DD w utc) okresu czasu budżetu. Nie przed bieżącym miesiącem dla ziarna czasu miesięcznego. Nie wcześniej niż trzy miesiące na ziarno czasu kwartalnych. Nie przed dwunastoma miesiącami na roczne ziarno czasu. Data rozpoczęcia w przyszłości nie przekracza trzech miesięcy.

Typ:	Nullable<T>[DateTime]
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-TimeGrain

Ziarno czasu budżetu może być miesięczne, kwartalne lub roczne.

Typ:	String
Dopuszczalne wartości:	Monthly, Quarterly, Annually
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

None

Dane wyjściowe

PSBudget

Uwagi

Obecnie zestaw SDK programu PowerShell dla użycia jest dostępny tylko dla klientów z umową Enterprise Agreement.
Zestaw SDK programu PowerShell do użycia korzysta ze starszej wersji interfejsu API budżetów, a kilka elementów niezgodnych z poprzednimi wersjami, takich jak wyświetlanie pozycji Budżety z filtrami, nie będzie działać zgodnie z oczekiwaniami.

Udostępnij za pośrednictwem