Compartilhar via


Get-AzReservation

Obtenha detalhes específicos Reservation .

Sintaxe

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

Obtenha detalhes específicos Reservation .

Exemplos

Exemplo 1: Obter a lista de pedidos de reserva no locatário atual

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

Obtenha a lista de pedidos de reserva no locatário atual. Por design, algumas propriedades não têm dados devido à resposta da API (por exemplo, LastUpdatedDateTime e SkuDescription). Nesse caso, obtenha a reserva única com o comando no exemplo 2 para obter os dados ausentes.

Alguns dados podem ser trucados devido à largura da exibição do PowerShell, anexando-a ao final do comando para mostrar os dados truncados: | ft -Envoltório

Exemplo 2: Obter os detalhes da reserva fornecidos ReservationOrderId e 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

Obtenha os detalhes de uma única reserva. Alguns dados podem ser trucados devido à largura da exibição do PowerShell, anexando-a ao final do comando para mostrar os dados truncados: | ft -Envoltório

Parâmetros

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Expand

O valor com suporte dessa consulta é renewProperties

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Filter

Pode ser usado para filtrar por propriedades de reserva. O filtro suporta 'eq', 'ou' e 'e'. Atualmente, ele não suporta 'ne', 'gt', 'le', 'ge' ou 'not'. As propriedades de reserva incluem sku/name, properties/{appliedScopeType, archived, displayName, displayProvisioningState, effectiveDateTime, expiryDate, expiryDateTime, provisioningState, quantity, renew, reservedResourceType, term, userFriendlyAppliedScopeType, userFriendlyRenewState}

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-First

Obtém apenas os primeiros 'n' objetos.

Tipo:UInt64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

ID do item de reserva

Tipo:String
Aliases:ReservationId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Parâmetro de identidade Para construir, consulte a seção NOTAS para propriedades INPUTOBJECT e crie uma tabela de hash.

Tipo:IReservationsIdentity
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Orderby

Pode ser usado para classificar a ordem por propriedades de reserva.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OrderId

ID do pedido da reserva

Tipo:String
Aliases:ReservationOrderId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SelectedState

O estado de provisionamento selecionado

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Skip

Ignora os primeiros 'n' objetos e, em seguida, obtém os objetos restantes.

Tipo:UInt64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

IReservationsIdentity

Saídas

IReservationResponse