Get-AzReservation

參考

模組:: Az.Reservations

取得特定 Reservation 詳細數據。

Syntax

Get-AzReservation
   [-Filter <String>]
   [-Orderby <String>]
   [-SelectedState <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzReservation
   -Id <String>
   -OrderId <String>
   [-Expand <String>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzReservation
   -OrderId <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzReservation
   -InputObject <IReservationsIdentity>
   [-Expand <String>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

取得特定 Reservation 詳細數據。

範例

範例 1：取得目前租使用者中的保留訂單清單

Get-AzReservation

Location   ReservationOrderId/ReservationId                                          Sku                           State     BenefitStartTime ExpiryDate            LastUpdatedDateTime SkuDescription
--------   --------------------------------                                          ---                           -----     ---------------- ----------            ------------------- --------------
centralus  a87c1742-0080-5b4d-b953-8531ad46fdc8/cad6fef7-ae86-4d47-91d0-67c897934bfe Standard_B1s                  Succeeded                  6/1/2024 12:00:00 AM
westeurope c5cf5c26-1920-4895-bf34-098ed1c69b92/6540137e-5a4f-4a14-bd17-3f2ea72b1ff4 premium_ssd_managed_disks_p30 Succeeded                  6/1/2022 12:00:00 AM
centralus  bd82bff8-4d29-9375-8194-ce0709fc1691/f2c3a058-b469-4529-88fa-1bae251c4a47 Standard_B1s                  Cancelled                  6/1/2024 12:00:00 AM

取得目前租使用者中的保留訂單清單。根據設計，某些 Proxy 由於 API 回應而沒有數據（例如 LastUpdatedDateTime 和 SkuDescription）。在此情況下，請使用範例 2 中的命令取得單一保留，以取得遺失的數據。

某些數據可能會因為 powershell 檢視的寬度而遭到截斷，因此將此附加至命令結尾以顯示截斷的數據： |ft -Wrap

範例 2：取得指定 ReservationOrderId 和 ReservationId 的保留詳細數據

Get-AzReservation -ReservationOrderId a87c1742-0080-5b4d-b953-8531ad46fdc8 -ReservationId cad6fef7-ae86-4d47-91d0-67c897934bfe

Location  ReservationOrderId/ReservationId                                          Sku          State     BenefitStartTime    ExpiryDate           LastUpdatedDateTime SkuDescription
--------  --------------------------------                                          ---          -----     ----------------    ----------           ------------------- --------------
centralus a87c1742-0080-5b4d-b953-8531ad46fdc8/cad6fef7-ae86-4d47-91d0-67c897934bfe Standard_B1s Succeeded 6/1/2021 5:01:58 PM 6/1/2024 12:00:00 AM 6/1/2021 5:02:09 PM Reserved VM Instance, Standard_B1s, US Central, 3 Years

取得單一保留的詳細數據。某些數據可能會因為 powershell 檢視的寬度而遭到截斷，因此將此附加至命令結尾以顯示截斷的數據： |ft -Wrap

參數

-DefaultProfile

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

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

-Expand

此查詢的支援值為 renewProperties

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

-Filter

可用來依保留屬性進行篩選。篩選支援『eq』、『or』和『and』。它目前不支援『ne』、'gt'、'le'、'ge'或 'not'。保留屬性包括 sku/name、properties/{appliedScopeType、archived、displayName、displayProvisioningState、effectiveDateTime、expiryDate、expiryDateTime、provisioningState、quantity、renew、reservedResourceType、term、userFriendlyAppliedScopeType、userFriendlyRenewState}

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

-First

只取得第一個『n』物件。

類型:	UInt64
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

-Orderby

可用來依保留屬性排序順序。

類型:	String
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

-SelectedState

選取的布建狀態

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

-Skip

忽略第一個 'n' 對象，然後取得其餘的物件。

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

輸入

IReservationsIdentity

輸出

IReservationResponse

共用方式為