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]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzReservation
   -ReservationOrderId <String>
   -Body <IPurchaseRequest>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<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]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

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

Description

在指定的 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 取得的保留訂單標識碼繼續購買保留。這是一個長時間執行的 POST 作業，可能需要大約 10 分鐘的時間。

參數

-AppliedScope

將套用權益的訂用帳戶清單。請勿指定 AppliedScopeType 是否為 Shared。此屬性將會取代為 Single AppliedScopeType，並取代為 appliedScopeProperties。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AppliedScopePropertyDisplayName

Display name

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AppliedScopePropertyManagementGroupId

必須套用權益之管理群組的完整標識符。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AppliedScopePropertyResourceGroupId

資源群組的完整標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AppliedScopePropertySubscriptionId

訂用帳戶的完整標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AppliedScopePropertyTenantId

儲存方案應套用權益的租用戶標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AppliedScopeType

套用範圍的類型。

類型:	AppliedScopeType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AsJob

以作業身分執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-BillingPlan

代表計費方案。

類型:	ReservationBillingPlan
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-BillingScopeId

購買保留或節省方案的訂用帳戶

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Body

要建構保留購買的要求，請參閱 BODY 屬性的 NOTES 一節，並建立哈希表。

類型:	IPurchaseRequest
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

DefaultProfile 參數無法運作。如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。

類型:	PSObject
別名:	AzureRMContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisplayName

保留的易記名稱

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

Identity Parameter To construct， see NOTES section for INPUTOBJECT properties and create a hash table.

類型:	IReservationsIdentity
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-InstanceFlexibility

開啟此選項會將保留折扣套用至相同 VM 大小群組中的其他 VM。只指定 VirtualMachines 保留的資源類型。

類型:	InstanceFlexibility
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Location

保留資源所在的 Azure 區域。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-NoWait

以異步方式執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Quantity

屬於保留一部分的 SKU 數量。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Renew

將此設定為 true 會自動在到期日時間購買新的保留。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ReservationOrderId

保留的訂單標識碼

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ReservedResourceType

正在保留的資源類型。

類型:	ReservedResourceType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ReviewDateTime

這是需要檢閱 Azure 混合式權益的日期時間。

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Sku

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Term

代表保留期限。

類型:	ReservationTerm
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

IPurchaseRequest

IReservationsIdentity

輸出

IReservationOrderResponse

共用方式為