Disable-SCVMHost

  • Referência
Módulo:
VirtualMachineManager

Coloca um host de máquina virtual no modo de manutenção.

Syntax

Disable-SCVMHost
       [-VMHost] <Host>
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [<CommonParameters>]
Disable-SCVMHost
       [-VMHost] <Host>
       [-MoveWithinCluster]
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [<CommonParameters>]

Description

O cmdlet Disable-SCVMHost coloca um host de máquina virtual gerenciado pelo VMM (Virtual Machine Manager) no modo de manutenção para que você possa executar tarefas de manutenção no host, como aplicar atualizações de segurança ou substituir o hardware.

Você pode usar o cmdlet Disable-SCVMHost para colocar hosts Hyper-V individuais, hosts VMware ESX ou hosts Citrix XenServer no modo de manutenção. Você também pode usar Disable-SCVMHost para colocar hosts clusterizados no modo de manutenção.

Para retornar o host ao serviço, use o cmdlet Enable-SCVMHost.

Para colocar hosts Hyper-V no modo de manutenção

Se o host pertence a um cluster que dá suporte à migração dinâmica, você pode escolher um dos seguintes métodos:

Método 1: migrar máquinas virtuais altamente disponíveis e salvar as outras máquinas virtuais. Quando o parâmetro MoveWithinCluster é usado com Disable-SCVMHost, o cmdlet usa a Migração Dinâmica para migrar todas as máquinas virtuais altamente disponíveis em execução para outros hosts no cluster. Ele coloca as máquinas virtuais em execução que não estão altamente disponíveis em um estado salvo, o que faz com que os usuários percam o serviço. Em seguida, ele coloca o host no modo de manutenção.

Método 2: salvar todas as máquinas virtuais. Disable-SCVMHost coloca todas as máquinas virtuais em execução em um estado salvo, o que faz com que os usuários percam o serviço. Em seguida, ele coloca o host no modo de manutenção.

Se o host não pertence a um cluster ou se pertence a um cluster que não dá suporte à migração dinâmica, Disable-SCVMHost coloca todas as máquinas virtuais em execução em um estado salvo, o que faz com que os usuários percam o serviço. Em seguida, ele coloca o host no modo de manutenção.

Como o Disable-SCVMHost funciona com hosts ESX do VMWare

Quando você coloca um host ESX no modo de manutenção usando Disable-SCVMHost, o VMM envia uma solicitação para inserir o modo de manutenção no VMware cCenter Server que gerencia esse host. O vCenter Server coloca o host ESX no modo de manutenção.

Observação: o comportamento do sistema das máquinas virtuais no host do Servidor ESX é determinado pela configuração do vCenter Server. Por exemplo, se o Agendador de Recursos Distribuídos do VMware não estiver configurado, talvez seja necessário desligar manualmente todas as máquinas virtuais no host. Ou talvez seja necessário mover as máquinas virtuais para outro host para colocar com êxito o host do Servidor ESX no modo de manutenção.

Para colocar hosts XenServer no modo de manutenção

Se o host pertence a um cluster que dá suporte à migração dinâmica, você pode escolher um dos seguintes métodos:

Método 1: migrar máquinas virtuais altamente disponíveis e salvar as outras máquinas virtuais. Quando o parâmetro MoveWithinCluster é usado com Disable-SCVMHost, o cmdlet usa a Migração Dinâmica do XenServer para migrar todas as máquinas virtuais altamente disponíveis em execução para outros hosts no cluster. Ele também coloca todas as máquinas virtuais em execução que não estão altamente disponíveis em um estado salvo, o que faz com que os usuários percam o serviço. Em seguida, ele coloca o host no modo de manutenção.

Método 2: salvar todas as máquinas virtuais. Desabilitar-VMHost coloca todas as máquinas virtuais em execução em um estado salvo, o que faz com que os usuários percam o serviço. Em seguida, ele coloca o host no modo de manutenção.

Se o host não pertence a um cluster ou se pertence a um cluster que não dá suporte à migração dinâmica, o Disable-VMHost coloca todas as máquinas virtuais em execução em um estado salvo, o que faz com que os usuários percam o serviço. Em seguida, ele coloca o host no modo de manutenção.

Comportamento do host no modo de manutenção

Depois de colocar um host no modo de manutenção, as seguintes ações serão afetadas:

  • Não é possível criar máquinas virtuais no host.
  • As máquinas virtuais não podem ser migradas para o host.
  • O host é excluído dos cálculos de classificações de host executados durante o posicionamento da máquina virtual.
  • O status do host não é atualizado.

No entanto, você pode executar as seguintes ações:

  • Remova o host do VMM se você verificar se o host está disponível e se seu agente está em um estado apropriado.
  • Iniciar ou parar máquinas virtuais no host.
  • Altere as propriedades do host.
  • Migre uma máquina virtual do host para outro host.

Exemplos

Exemplo 1: colocar o host especificado no modo de manutenção e salvar todas as máquinas virtuais em execução

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01" 
PS C:\> Disable-SCVMHost -VMHost $VMHost

O primeiro comando obtém o objeto host chamado VMHost01 e armazena o objeto na variável $VMHost.

O segundo comando coloca todas as máquinas virtuais em execução implantadas no host armazenado em $VMHost em um estado salvo. Em seguida, ele define o status do host como "No Modo de Manutenção".

Exemplo 2: Usar a migração dinâmica para migrar todas as máquinas virtuais altamente disponíveis em execução em um nó de cluster que está no modo de manutenção

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> Disable-SCVMHost -VMHost $VMHost -MoveWithinCluster

O primeiro comando obtém o objeto host chamado VMHost02 e armazena o objeto na variável $VMHost.

O segundo comando usa a migração dinâmica para migrar todas as máquinas virtuais altamente disponíveis em execução no host armazenado em $VMHost para outro nó no cluster. Ele coloca outras máquinas virtuais em execução em um estado salvo e, em seguida, define o valor da propriedade de estado do host como "No Modo de Manutenção".

Parâmetros

-JobVariable

Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MoveWithinCluster

Indica que todas as máquinas virtuais implantadas atualmente em um host que é membro de um cluster host serão migradas para outro host no mesmo cluster de host se esse host for colocado no modo de manutenção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHost

Especifica um objeto host de máquina virtual. O VMM dá suporte a hosts Hyper-V, hosts ESX VMware e hosts Citrix XenServer.

Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost .

Type:Host
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Saídas

Host

Esse cmdlet retorna um objeto Host .

Observações

  • Um host que você coloca no modo de manutenção temporária é diferente de um host que você designa como um host de manutenção. Um host de manutenção é um host que você dedica para tarefas de manutenção de máquina virtual, como o seguinte:
  • Aplicação de patch de modelos e máquinas virtuais armazenadas.
  • Preparo da criação de máquina virtual com script antes de mover as máquinas virtuais para o ambiente de produção.