New-AzReservation

모듈:

Az.Reservations

지정된 URI에 따라 리소스를 구매 ReservationOrder 하고 만듭니다.

Syntax

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

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에서 얻은 예약 주문 ID를 사용하여 예약 구매를 진행합니다. 이 작업은 약 10분 정도 걸릴 수 있는 장기 실행 POST 작업입니다.

매개 변수

-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

-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

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

-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

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

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이 공유되는지 지정하지 마세요. 이 속성은 더 이상 사용되지 않으며 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>: ID 매개 변수

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