New-AzReservation

モジュール:

Az.Reservations

指定した URI でリソースを購入 ReservationOrder して作成します。

構文

New-AzReservation
   -ReservationOrderId <String>
   [-AppliedScope <String[]>]
   [-AppliedScopePropertyDisplayName <String>]
   [-AppliedScopePropertyManagementGroupId <String>]
   [-AppliedScopePropertyResourceGroupId <String>]
   [-AppliedScopePropertySubscriptionId <String>]
   [-AppliedScopePropertyTenantId <String>]
   [-AppliedScopeType <AppliedScopeType>]
   [-BillingPlan <ReservationBillingPlan>]
   [-BillingScopeId <String>]
   [-DisplayName <String>]
   [-InstanceFlexibility <InstanceFlexibility>]
   [-Location <String>]
   [-Quantity <Int32>]
   [-Renew]
   [-ReservedResourceType <ReservedResourceType>]
   [-ReviewDateTime <DateTime>]
   [-Sku <String>]
   [-Term <ReservationTerm>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

New-AzReservation
   -ReservationOrderId <String>
   -Body <IPurchaseRequest>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

New-AzReservation
   -InputObject <IReservationsIdentity>
   -Body <IPurchaseRequest>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

New-AzReservation
   -InputObject <IReservationsIdentity>
   [-AppliedScope <String[]>]
   [-AppliedScopePropertyDisplayName <String>]
   [-AppliedScopePropertyManagementGroupId <String>]
   [-AppliedScopePropertyResourceGroupId <String>]
   [-AppliedScopePropertySubscriptionId <String>]
   [-AppliedScopePropertyTenantId <String>]
   [-AppliedScopeType <AppliedScopeType>]
   [-BillingPlan <ReservationBillingPlan>]
   [-BillingScopeId <String>]
   [-DisplayName <String>]
   [-InstanceFlexibility <InstanceFlexibility>]
   [-Location <String>]
   [-Quantity <Int32>]
   [-Renew]
   [-ReservedResourceType <ReservedResourceType>]
   [-ReviewDateTime <DateTime>]
   [-Sku <String>]
   [-Term <ReservationTerm>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

説明

指定した URI でリソースを購入 ReservationOrder して作成します。

例

例 1: 新しい予約を作成する

New-AzReservation -AppliedScopeType 'Shared' -BillingPlan 'Upfront' -billingScopeId '/subscriptions/b0f278e1-1f18-4378-84d7-b44dfa708665' -DisplayName 'TestVm2222' -Location 'westus' -Quantity 1 -ReservedResourceType 'VirtualMachines' -Sku 'Standard_b1ls' -Term 'P1Y' -ReservationOrderId '846655fa-d9e7-4fb8-9512-3ab7367352f1'

ReservationOrderId                   DisplayName Term State     Quantity
------------------                   ----------- ---- -----     --------
846655fa-d9e7-4fb8-9512-3ab7367352f1 TestVm2222  P1Y  Succeeded 1

Get-AzReservationQuote から取得した予約注文 ID を使用して予約購入を続行します。 これは実行時間の長い POST 操作で、約 10 分かかる場合があります。

パラメーター

-AppliedScope

特典が適用されるサブスクリプションの一覧。 AppliedScopeType が Shared かどうかを指定しないでください。 このプロパティは非推奨となり、Single AppliedScopeType の代わりに appliedScopeProperties に置き換えられます。

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

-AppliedScopePropertyDisplayName

[表示名]

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

-AppliedScopePropertyManagementGroupId

特典を適用する必要がある管理グループの完全修飾識別子。

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

-AppliedScopePropertyResourceGroupId

リソース グループの完全修飾識別子。

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

-AppliedScopePropertySubscriptionId

サブスクリプションの完全修飾識別子。

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

-AppliedScopePropertyTenantId

節約計画で特典を適用する必要があるテナント ID。

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

-AppliedScopeType

適用されたスコープの種類。

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

-AsJob

コマンドをジョブとして実行する

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

-BillingPlan

課金プランを表します。

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

-BillingScopeId

予約または割引プランの購入に対して課金されるサブスクリプション

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

-Body

予約購入の要求を作成するには、BODY プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

Type:	IPurchaseRequest
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

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

-DefaultProfile

DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

予約のフレンドリ名

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

-InputObject

ID パラメーターを構築するには、INPUTOBJECT プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

Type:	IReservationsIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstanceFlexibility

これをオンにすると、同じ VM サイズ グループ内の他の VM に予約割引が適用されます。 VirtualMachines の予約済みリソースの種類にのみ指定します。

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

-Location

予約済みリソースが存在する Azure リージョン。

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

-NoWait

コマンドを非同期的に実行する

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

-Quantity

予約の一部である SKU の数量。

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

-Renew

これを true に設定すると、有効期限の日時に新しい予約が自動的に購入されます。

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

-ReservationOrderId

予約の注文 ID

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

-ReservedResourceType

予約されているリソースの種類。

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

-ReviewDateTime

これは、Azure ハイブリッド特典を確認する必要がある日時です。

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

-Sku

.

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

-Term

予約の期間を表します。

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

-WhatIf

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

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

入力

IPurchaseRequest

IReservationsIdentity

出力

IReservationOrderResponse

メモ

別名

複合パラメーターのプロパティ

以下で説明するパラメーターを作成するには、適切なプロパティを含むハッシュ テーブルを作成します。 ハッシュ テーブルの詳細については、Get-Help about_Hash_Tablesを実行します。

BODY <IPurchaseRequest>: 予約購入の要求

• [AppliedScopePropertyDisplayName <String>]: 表示名
• [AppliedScopePropertyManagementGroupId <String>]: 特典を適用する必要がある管理グループの完全修飾識別子。
• [AppliedScopePropertyResourceGroupId <String>]: リソース グループの完全修飾識別子。
• [AppliedScopePropertySubscriptionId <String>]: サブスクリプションの完全修飾識別子。
• [AppliedScopePropertyTenantId <String>]: 節約計画が特典を適用する必要があるテナント ID。
• [AppliedScopeType <AppliedScopeType?>]: 適用されたスコープの型。
• [AppliedScopes <String[]>]: 特典が適用されるサブスクリプションの一覧。 AppliedScopeType が Shared かどうかを指定しないでください。 このプロパティは非推奨となり、Single AppliedScopeType の代わりに appliedScopeProperties に置き換えられます。
• [BillingPlan <ReservationBillingPlan?>]: 課金プランを表します。
• [BillingScopeId <String>]: 予約または割引プランの購入に対して課金されるサブスクリプション
• [DisplayName <String>]: 予約のフレンドリ名
• [InstanceFlexibility <InstanceFlexibility?>]: これをオンにすると、同じ VM サイズ グループ内の他の VM に予約割引が適用されます。 VirtualMachines の予約済みリソースの種類にのみ指定します。
• [Location <String>]: 予約済みリソースが存在する Azure リージョン。
• [Quantity <Int32?>]: 予約の一部である SKU の数量。
• [Renew <Boolean?>]: これを true に設定すると、有効期限の日時に新しい予約が自動的に購入されます。
• [ReservedResourceType <ReservedResourceType?>]: 予約されているリソースの種類。
• [ReviewDateTime <DateTime?>]: これは、Azure ハイブリッド特典を確認する必要がある日時です。
• [Sku <String>]:
• [Term <ReservationTerm?>]: 予約の期間を表します。

INPUTOBJECT <IReservationsIdentity>: IDENTITY パラメーター

• [Id <String>]: リソース ID パス
• [ReservationId <String>]: 予約項目の ID
• [ReservationOrderId <String>]: 予約の注文 ID
• [SubscriptionId <String>]: サブスクリプションの ID