Update-AzReservation

參考

模組:: Az.Reservations

更新所Reservation套用的範圍。

Syntax

Update-AzReservation
      -Id <String>
      -OrderId <String>
      [-AppliedScope <String[]>]
      [-AppliedScopePropertyDisplayName <String>]
      [-AppliedScopePropertyManagementGroupId <String>]
      [-AppliedScopePropertyResourceGroupId <String>]
      [-AppliedScopePropertySubscriptionId <String>]
      [-AppliedScopePropertyTenantId <String>]
      [-AppliedScopeType <AppliedScopeType>]
      [-InstanceFlexibility <InstanceFlexibility>]
      [-Name <String>]
      [-Renew]
      [-RenewProperty <IPatchPropertiesRenewProperties>]
      [-ReviewDateTime <DateTime>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzReservation
      -Id <String>
      -OrderId <String>
      -Reservation <IPatch>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzReservation
      -InputObject <IReservationsIdentity>
      [-AppliedScope <String[]>]
      [-AppliedScopePropertyDisplayName <String>]
      [-AppliedScopePropertyManagementGroupId <String>]
      [-AppliedScopePropertyResourceGroupId <String>]
      [-AppliedScopePropertySubscriptionId <String>]
      [-AppliedScopePropertyTenantId <String>]
      [-AppliedScopeType <AppliedScopeType>]
      [-InstanceFlexibility <InstanceFlexibility>]
      [-Name <String>]
      [-Renew]
      [-RenewProperty <IPatchPropertiesRenewProperties>]
      [-ReviewDateTime <DateTime>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzReservation
      -InputObject <IReservationsIdentity>
      -Reservation <IPatch>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

更新所Reservation套用的範圍。

範例

範例 1：更新保留的屬性

Update-AzReservation -ReservationOrderId "30000000-aaaa-bbbb-cccc-200000000013" -ReservationId "10000000-aaaa-bbbb-cccc-200000000007" -Name "testName"

Location   ReservationOrderId/ReservationId                                             Sku           State     BenefitStartTime     ExpiryDate            LastUpdatedDateTime  SkuDescription
--------   --------------------------------                                             ---           -----     ----------------     ----------            -------------------  --------------
westeurope 30000000-aaaa-bbbb-cccc-200000000013/10000000-aaaa-bbbb-cccc-200000000007/16 Standard_B4ms Succeeded 6/14/2022 9:41:17 PM 6/14/2025 12:00:00 AM 7/7/2022 11:37:58 PM Reserved VM In…

更新保留的屬性，包括名稱、更新、appliedScopeType、appliedScope

範例 2：更新保留的 AppliedScopeType

# Shared scope:
Update-AzReservation -ReservationOrderId "30000000-aaaa-bbbb-cccc-200000000013" -ReservationId "10000000-aaaa-bbbb-cccc-200000000007" -AppliedScopeType "Shared"

# Single scope:
Update-AzReservation -ReservationOrderId "30000000-aaaa-bbbb-cccc-200000000013" -ReservationId "10000000-aaaa-bbbb-cccc-200000000007" -AppliedScopeType "Single" -AppliedScope "/subscriptions/30000000-aaaa-bbbb-cccc-200000000018"

# Single scope with resource group:
Update-AzReservation -ReservationOrderId "30000000-aaaa-bbbb-cccc-200000000013" -ReservationId "10000000-aaaa-bbbb-cccc-200000000007" -AppliedScopeType "Single" -AppliedScope "/subscriptions/30000000-aaaa-bbbb-cccc-200000000018/resourcegroups/{your resource group name}"

Similar to example 1

更新保留已套用的範圍類型。針對 [共用範圍]，請勿傳入任何套用的範圍標識符。針對 [單一範圍]，傳入已套用的範圍標識符，針對具有資源群組的單一範圍，也會傳入套用範圍標識符中的資源組名

參數

-AppliedScope

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

類型:	String[]
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopePropertyDisplayName

Display name

類型:	String
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopePropertyManagementGroupId

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

類型:	String
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopePropertyResourceGroupId

資源群組的完整標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopePropertySubscriptionId

訂用帳戶的完整標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopePropertyTenantId

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

類型:	String
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopeType

套用範圍的類型。

類型:	AppliedScopeType
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

以作業身分執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

類型:	SwitchParameter
Aliases:	cf
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

類型:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

保留項目的識別碼

類型:	String
Aliases:	ReservationId
Position:	Named
預設值:	None
必要:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

類型:	IReservationsIdentity
Position:	Named
預設值:	None
必要:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstanceFlexibility

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

類型:	InstanceFlexibility
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

保留的顯示名稱

類型:	String
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

以異步方式執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OrderId

保留的訂單標識碼

類型:	String
Aliases:	ReservationOrderId
Position:	Named
預設值:	None
必要:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Renew

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

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RenewProperty

. 若要建構，請參閱 RENEWPROPERTY 屬性和建立哈希表的 NOTES 一節。

類型:	IPatchPropertiesRenewProperties
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Reservation

保留修補程式的要求若要建構，請參閱 RESERVATION 屬性的 NOTES 一節，並建立哈希表。

類型:	IPatch
Position:	Named
預設值:	None
必要:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReviewDateTime

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

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

類型:	SwitchParameter
Aliases:	wi
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

IPatch

IReservationsIdentity

輸出

IReservationResponse

共用方式為