Compartilhar via

Set-AzVM

  • Referência
Módulo:
Az.Compute

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

Set-AzVM
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Generalized]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzVM
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Redeploy]
   [-AsJob]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzVM
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Reapply]
   [-AsJob]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzVM
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-SimulateEviction]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzVM
   [-Id] <String>
   [-Generalized]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzVM
   [-Id] <String>
   [-Redeploy]
   [-AsJob]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzVM
   [-Id] <String>
   [-Reapply]
   [-AsJob]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
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.

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

-DefaultProfile

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

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

-Generalized

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

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

-Id

Especifica a ID do recurso da máquina virtual.

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

-Name

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

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

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

-Reapply

Para reaplicar a máquina virtual.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

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

-ResourceGroupName

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

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

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

Entradas

String

Saídas

PSComputeLongRunningOperation

PSAzureOperationResponse