New-AzConsumptionBudget

リファレンス

モジュール:: Az.Billing

サブスクリプションまたはリソースグループに予算を作成します。

構文

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

説明

New-AzConsumptionBudget コマンドレットは、サブスクリプションまたはリソースグループに予算を作成します。

例

例 1: サブスクリプションレベルで予算名を使用してコスト予算を作成する

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

例 2: リソースグループレベルで予算名を使用してコスト予算を作成する

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

パラメーター

-Amount

予算の金額。

Type:	Decimal
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Category

予算のカテゴリには、コストまたは使用量を指定できます。

Type:	String
Accepted values:	Cost, Usage
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ContactEmail

しきい値を超えたときに予算通知を送信するアドレスをEmailします。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ContactGroup

しきい値を超えたときに予算通知を送信するアクショングループ。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ContactRole

しきい値を超えたときに予算通知を送信する連絡先ロール。

Type:	String[]
Accepted values:	Owner, Reader, Contributor
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EndDate

予算の期間の終了日 (UTC では YYYY-MM-DD)。

Type:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MeterFilter

フィルター処理するメートルのコンマ区切りの一覧。カテゴリが使用されている場合は必須です。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

予算の名前。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NotificationEnabled

通知が有効かどうか。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NotificationKey

通知が有効なスイッチ、通知のしきい値、連絡先メール、連絡先グループ、または連絡先ロールを含む通知を作成するために必要な、予算に関連付けられている通知のキー。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NotificationThreshold

通知に関連付けられているしきい値。コストまたは使用量がしきい値を超えた場合に通知が送信されます。これは常にパーセントであり、0 から 1000 の間である必要があります。

Type:	Nullable<T>[Decimal]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceFilter

フィルター処理するリソースインスタンスのコンマ区切りの一覧。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupFilter

フィルター処理するリソースグループのコンマ区切りの一覧。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

予算のリソースグループ。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-StartDate

予算の期間の開始日 (UTC では YYYY-MM-DD)。毎月の時間グレインの現在の月より前ではありません。四半期ごとの時間グレインの場合は 3 か月前ではありません。年単位の時間グレインでは、12 か月前ではありません。将来の開始日は 3 か月以下です。

Type:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeGrain

予算の時間のグレインは、月単位、四半期ごと、または毎年にすることができます。

Type:	String
Accepted values:	Monthly, Quarterly, Annually
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

入力

None

出力

PSBudget

メモ

現在、PowerShell SDK for Consumption は、Enterprise Agreementのお客様のみが使用できます。
PowerShell SDK for Consumption では、古いバージョンの Budgets API が使用されており、フィルターを使用して Budgets を一覧表示するような下位互換性のない項目はほとんど期待どおりに機能しません。

New-AzConsumptionBudget

構文

説明

例

例 1: サブスクリプション レベルで予算名を使用してコスト予算を作成する

例 2: リソース グループ レベルで予算名を使用してコスト予算を作成する

パラメーター

入力

出力

メモ

フィードバック

例 1: サブスクリプションレベルで予算名を使用してコスト予算を作成する

例 2: リソースグループレベルで予算名を使用してコスト予算を作成する