Compartilhar via


Set-AzVM

Esse cmdlet pode ser usado para fazer o seguinte: reaplicar ou reimplantar uma máquina virtual, marcar uma máquina virtual como generalizada, simular remoção para uma máquina virtual spot.

Sintaxe

GeneralizeResourceGroupNameParameterSetName (Default)

Set-AzVM
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Generalized]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

RedeployResourceGroupNameParameterSetName

Set-AzVM
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Redeploy]
    [-AsJob]
    [-NoWait]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ReapplyResourceGroupNameParameterSetName

Set-AzVM
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Reapply]
    [-AsJob]
    [-NoWait]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SimulateEvictionResourceGroupNameParameterSetName

Set-AzVM
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-SimulateEviction]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GeneralizeIdParameterSetName

Set-AzVM
    [-Id] <String>
    [-Generalized]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

RedeployIdParameterSetName

Set-AzVM
    [-Id] <String>
    [-Redeploy]
    [-AsJob]
    [-NoWait]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ReapplyIdParameterSetName

Set-AzVM
    [-Id] <String>
    [-Reapply]
    [-AsJob]
    [-NoWait]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SimulateEvictionIdParameterSetName

Set-AzVM
    [-Id] <String>
    [-SimulateEviction]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

O cmdlet Set-AzVM pode ser usado para reimplantar ou reaplicar uma máquina virtual. Ele também pode ser usado para marcar uma máquina virtual como generalizada ou simular a remoção para uma máquina virtual spot.
Antes de marcar uma máquina virtual como generalizada, faça logon na máquina virtual e use o Sysprep para preparar o disco rígido. Veja aqui para obter mais informações.

Exemplos

Exemplo 1: Marcar uma máquina virtual como generalizada

Set-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Generalized

Esse comando marca a máquina virtual chamada "VirtualMachine07" como generalizada.

Exemplo 2: Simular a remoção para uma máquina virtual spot usando a ID do recurso

$vm = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Set-AzVM -Id $vm.id -SimulateEviction

Esse comando simula a remoção para a máquina virtual chamada "VirtualMachine07" usando a ID do recurso.

Exemplo 3: reaplicar uma máquina virtual

Set-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Reapply

Esse comando reaplica a máquina virtual chamada "VirtualMachine07".

Exemplo 4: Reimplantar uma máquina virtual usando a ID do recurso

$vm = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Set-AzVM -Id $vm.id -Redeploy

Esse comando implanta a máquina virtual chamada "VirtualMachine07" usando a ID do recurso.

Parâmetros

-AsJob

Execute o cmdlet em segundo plano e retorne um trabalho para acompanhar o progresso.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Generalized

Indica que esse cmdlet marca uma máquina virtual como generalizada.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

GeneralizeResourceGroupNameParameterSetName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
GeneralizeIdParameterSetName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Id

Especifica a ID do recurso da máquina virtual.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

GeneralizeIdParameterSetName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
RedeployIdParameterSetName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ReapplyIdParameterSetName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
SimulateEvictionIdParameterSetName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Especifica o nome da máquina virtual na qual esse cmdlet opera.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

GeneralizeResourceGroupNameParameterSetName
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
RedeployResourceGroupNameParameterSetName
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ReapplyResourceGroupNameParameterSetName
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
SimulateEvictionResourceGroupNameParameterSetName
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-NoWait

Inicia a operação e retorna imediatamente, antes que a operação seja concluída. Para determinar se a operação foi concluída com êxito, use algum outro mecanismo.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RedeployResourceGroupNameParameterSetName
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ReapplyResourceGroupNameParameterSetName
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RedeployIdParameterSetName
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ReapplyIdParameterSetName
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Reapply

Para reaplicar a máquina virtual.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ReapplyResourceGroupNameParameterSetName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ReapplyIdParameterSetName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Redeploy

Indica que esse cmdlet reimplanta manualmente a máquina virtual em um host diferente do Azure para corrigir quaisquer problemas. Se você reimplantar uma máquina virtual, ela será reiniciada, o que resultará na perda de dados da unidade efêmera.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RedeployResourceGroupNameParameterSetName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RedeployIdParameterSetName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

Especifica o nome do grupo de recursos da máquina virtual.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

GeneralizeResourceGroupNameParameterSetName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
RedeployResourceGroupNameParameterSetName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ReapplyResourceGroupNameParameterSetName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
SimulateEvictionResourceGroupNameParameterSetName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SimulateEviction

Indica que esse cmdlet simula a remoção da máquina virtual spot. A remoção ocorrerá dentro de 30 minutos após chamar a API.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SimulateEvictionResourceGroupNameParameterSetName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SimulateEvictionIdParameterSetName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Saídas

PSComputeLongRunningOperation

PSAzureOperationResponse