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

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

Update-AzReservation
      -InputObject <IReservationsIdentity>
      -Reservation <IPatch>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<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]
      [-Confirm]
      [-WhatIf]
      [<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

예약의 적용된 범위 유형을 업데이트합니다. 공유 범위의 경우 적용된 범위 ID를 전달하지 마세요. 단일 범위의 경우 적용된 범위 ID를 전달하고 리소스 그룹을 사용하여 단일 범위에 대해 적용된 범위 ID에 리소스 그룹 이름도 전달합니다.

매개 변수

-AppliedScope

혜택이 적용될 구독 목록입니다. AppliedScopeType이 공유되는지 지정하지 마세요. 이 속성은 더 이상 사용되지 않으며 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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-DefaultProfile

DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.

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

-Id

예약 항목의 ID

Type:	String
Aliases:	ReservationId
Position:	Named
Default value:	None
Required:	True
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

-Name

예약의 표시 이름

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

-OrderId

예약의 주문 ID

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

-Renew

이를 true로 설정하면 만료 날짜 시간에 새 예약이 자동으로 구매됩니다. -Renew:$true 또는 -Renew:$false 선택할 수 있습니다.

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

-RenewProperty

. 생성하려면 RENEWPROPERTY 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-Reservation

예약 패치에 대한 요청 생성하려면 RESERVATION 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-ReviewDateTime

Azure 하이브리드 혜택을 검토해야 하는 날짜-시간입니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

IPatch

IReservationsIdentity

출력

IReservationResponse

참고

별칭

복합 매개 변수 속성

아래에 설명된 매개 변수를 만들려면 적절한 속성을 포함하는 해시 테이블을 생성합니다. 해시 테이블에 대한 자세한 내용은 Get-Help about_Hash_Tables 실행합니다.

INPUTOBJECT <IReservationsIdentity>: ID 매개 변수

[Id <String>]: 리소스 ID 경로
[ReservationId <String>]: 예약 항목의 ID
[ReservationOrderId <String>]: 예약의 주문 ID
[SubscriptionId <String>]: 구독의 ID

RENEWPROPERTY <IPatchPropertiesRenewProperties>: .

[PurchaseProperty <IPurchaseRequest>]: 예약 구매 요청
- [AppliedScopePropertyDisplayName <String>]: 표시 이름
- [AppliedScopePropertyManagementGroupId <String>]: 혜택을 적용해야 하는 관리 그룹의 정규화된 식별자입니다.
- [AppliedScopePropertyResourceGroupId <String>]: 리소스 그룹의 정규화된 식별자입니다.
- [AppliedScopePropertySubscriptionId <String>]: 구독의 정규화된 식별자입니다.
- [AppliedScopePropertyTenantId <String>]: 저축 계획이 혜택을 적용해야 하는 테넌트 ID입니다.
- [AppliedScopeType <AppliedScopeType?>]: 적용된 범위의 형식입니다.
- [AppliedScopes <String[]>]: 혜택이 적용될 구독 목록입니다. AppliedScopeType이 공유되는지 지정하지 마세요. 이 속성은 더 이상 사용되지 않으며 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?>]: 예약 기간을 나타냅니다.

RESERVATION <IPatch>: 예약 패치 요청

[AppliedScope <String[]>]: 혜택이 적용될 구독 목록입니다. AppliedScopeType이 공유되는지 지정하지 마세요. 이 속성은 더 이상 사용되지 않으며 Single AppliedScopeType 대신 appliedScopeProperties로 대체됩니다.
[AppliedScopePropertyDisplayName <String>]: 표시 이름
[AppliedScopePropertyManagementGroupId <String>]: 혜택을 적용해야 하는 관리 그룹의 정규화된 식별자입니다.
[AppliedScopePropertyResourceGroupId <String>]: 리소스 그룹의 정규화된 식별자입니다.
[AppliedScopePropertySubscriptionId <String>]: 구독의 정규화된 식별자입니다.
[AppliedScopePropertyTenantId <String>]: 저축 계획이 혜택을 적용해야 하는 테넌트 ID입니다.
[AppliedScopeType <AppliedScopeType?>]: 적용된 범위의 형식입니다.
[InstanceFlexibility <InstanceFlexibility?>]: 이 기능을 켜면 동일한 VM 크기 그룹의 다른 VM에 예약 할인이 적용됩니다. VirtualMachines 예약 리소스 종류에 대해서만 지정합니다.
[Name <String>]: 예약의 표시 이름
[Renew <Boolean?>]: 이 값을 true로 설정하면 만료 날짜 시간에 새 예약이 자동으로 구매됩니다.
[RenewProperty <IPatchPropertiesRenewProperties>]:
- [PurchaseProperty <IPurchaseRequest>]: 예약 구매 요청
  - [AppliedScopePropertyDisplayName <String>]: 표시 이름
  - [AppliedScopePropertyManagementGroupId <String>]: 혜택을 적용해야 하는 관리 그룹의 정규화된 식별자입니다.
  - [AppliedScopePropertyResourceGroupId <String>]: 리소스 그룹의 정규화된 식별자입니다.
  - [AppliedScopePropertySubscriptionId <String>]: 구독의 정규화된 식별자입니다.
  - [AppliedScopePropertyTenantId <String>]: 저축 계획이 혜택을 적용해야 하는 테넌트 ID입니다.
  - [AppliedScopeType <AppliedScopeType?>]: 적용된 범위의 형식입니다.
  - [AppliedScopes <String[]>]: 혜택이 적용될 구독 목록입니다. AppliedScopeType이 공유되는지 지정하지 마세요. 이 속성은 더 이상 사용되지 않으며 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?>]: 예약 기간을 나타냅니다.
[ReviewDateTime <DateTime?>]: Azure 하이브리드 혜택을 검토해야 하는 날짜-시간입니다.

Share via