Partilhar via

Set-AzVM

Módulo:
Az.Compute Module

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

Sintaxe

GeneralizeResourceGroupNameParameterSetName (Predefinição) 

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 local.
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. Consulte aqui para obter mais informações.

Exemplos

Exemplo 1: Marcar uma máquina virtual como generalizada

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

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

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

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

Este 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

Este 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

Este 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 Job para acompanhar o progresso.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Generalized

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

GeneralizeResourceGroupNameParameterSetName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
GeneralizeIdParameterSetName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Id

Especifica a ID do Recurso da máquina virtual.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

GeneralizeIdParameterSetName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
RedeployIdParameterSetName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ReapplyIdParameterSetName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
SimulateEvictionIdParameterSetName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

GeneralizeResourceGroupNameParameterSetName
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
RedeployResourceGroupNameParameterSetName
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ReapplyResourceGroupNameParameterSetName
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
SimulateEvictionResourceGroupNameParameterSetName
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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 dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

RedeployResourceGroupNameParameterSetName
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ReapplyResourceGroupNameParameterSetName
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
RedeployIdParameterSetName
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ReapplyIdParameterSetName
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Reapply

Para reaplicar a máquina virtual.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ReapplyResourceGroupNameParameterSetName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ReapplyIdParameterSetName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 efêmeros da unidade.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

RedeployResourceGroupNameParameterSetName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
RedeployIdParameterSetName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceGroupName

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

GeneralizeResourceGroupNameParameterSetName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
RedeployResourceGroupNameParameterSetName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ReapplyResourceGroupNameParameterSetName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
SimulateEvictionResourceGroupNameParameterSetName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-SimulateEviction

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SimulateEvictionResourceGroupNameParameterSetName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
SimulateEvictionIdParameterSetName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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