Update-AzReservation

Referência

Módulo:: Az.Reservations

Atualiza os escopos aplicados do Reservation.

Sintaxe

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

Atualiza os escopos aplicados do Reservation.

Exemplos

Exemplo 1: Atualizar as propriedades da reserva

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…

Atualizar propriedades da reserva, incluindo name, renew, appliedScopeType, appliedScope

Exemplo 2: Atualizar AppliedScopeType da reserva

# 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

Atualize o tipo de escopo aplicado da Reserva. Para Escopo compartilhado, não passe nenhuma id de escopo aplicada. Para Escopo único, passe a id de escopo aplicado e para Escopo único com grupo de recursos, passe também o nome do grupo de recursos na id de escopo aplicada

Parâmetros

-AppliedScope

Lista das subscrições em que o benefício será aplicado. Não especifique se AppliedScopeType é compartilhado. Essa propriedade será preterida e substituída por appliedScopeProperties em vez de Single AppliedScopeType.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-AppliedScopePropertyDisplayName

Nome para exibição

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-AppliedScopePropertyManagementGroupId

Identificador totalmente qualificado do grupo de gestão em que o benefício deve ser aplicado.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-AppliedScopePropertyResourceGroupId

Identificador totalmente qualificado do grupo de recursos.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-AppliedScopePropertySubscriptionId

Identificador totalmente qualificado da assinatura.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-AppliedScopePropertyTenantId

ID do inquilino onde o plano de poupança deve aplicar o benefício.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-AppliedScopeType

Tipo do Escopo Aplicado.

Tipo:	AppliedScopeType
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-AsJob

Executar o comando como um trabalho

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultProfile

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

Tipo:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Id

ID do item de reserva

Tipo:	String
Aliases:	ReservationId
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InputObject

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

Tipo:	IReservationsIdentity
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-InstanceFlexibility

Ativar isso aplicará o desconto de reserva a outras VMs no mesmo grupo de tamanho de VM. Especifique apenas para o tipo de recurso reservado VirtualMachines.

Tipo:	InstanceFlexibility
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Name

Nome de exibição da reserva

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NoWait

Execute o comando de forma assíncrona

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-OrderId

ID da encomenda da reserva

Tipo:	String
Aliases:	ReservationOrderId
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Renew

Definir isso como true comprará automaticamente uma nova reserva no horário da data de validade.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-RenewProperty

. Para construir, consulte a seção NOTAS para propriedades RENEWPROPERTY e crie uma tabela de hash.

Tipo:	IPatchPropertiesRenewProperties
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Reservation

A solicitação de patch de reserva Para construir, consulte a seção NOTAS para propriedades RESERVATION e crie uma tabela de hash.

Tipo:	IPatch
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ReviewDateTime

Esta é a data e hora em que o benefício híbrido do Azure precisa ser revisado.

Tipo:	DateTime
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

IPatch

IReservationsIdentity

Saídas

IReservationResponse

Partilhar via