Update-AzReservation

Referência

Módulo:: Az.Reservations

Atualiza os escopos aplicados do 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]
      [-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 nome, renovar, 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

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

Parâmetros

-AppliedScope

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

Tipo:	String[]
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopePropertyDisplayName

Nome de exibição

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopePropertyManagementGroupId

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

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopePropertyResourceGroupId

Identificador totalmente qualificado do grupo de recursos.

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopePropertySubscriptionId

Identificador totalmente qualificado da assinatura.

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopePropertyTenantId

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

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppliedScopeType

Tipo do escopo aplicado.

Tipo:	AppliedScopeType
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Executar o comando como um trabalho

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-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
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

ID do item de reserva

Tipo:	String
Aliases:	ReservationId
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	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
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstanceFlexibility

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

Tipo:	InstanceFlexibility
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Nome de exibição da reserva

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

Execute o comando de forma assíncrona

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OrderId

ID do pedido da reserva

Tipo:	String
Aliases:	ReservationOrderId
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Renew

Definir isso como true comprará automaticamente uma nova reserva na data de expiração, hora.

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RenewProperty

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

Tipo:	IPatchPropertiesRenewProperties
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	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
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReviewDateTime

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

Tipo:	DateTime
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

IPatch

IReservationsIdentity

Saídas

IReservationResponse

Compartilhar via