Compartilhar via

Stop-SCVMHost

  • Referência
Módulo:
VirtualMachineManager

Interrompe um host gerenciado pelo VMM.

Sintaxe

Stop-SCVMHost
    [-VMHost] <Host>
    [-UseOutOfBandChannel]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Stop-SCVMHost interrompe um host gerenciado pelo VMM (Virtual Machine Manager) emitindo um comando do Power Off.

Há dois métodos pelos quais você pode parar um host: dentro da banda e fora de banda (OOB). O conjunto de parâmetros padrão usa o método em banda para desligar o host. Para usar o método OOB, o host deve ser configurado para o gerenciamento do OOB. Para obter informações sobre como definir as configurações do BMC (Controlador de Gerenciamento de Placa Base) para um host, digite Get-Help Set-SCVMHost -Detailed.

Exemplos

Exemplo 1: desligar um host especificado usando o gerenciamento em banda

PS C:\> Get-SCVMHost -ComputerName "NewHost01" | Stop-SCVMHost -Confirm

Esse comando obtém o objeto host chamado NewHost01 e alimenta o host. O comando solicita que você confirme a ação antes de prosseguir.

Exemplo 2: desligar um host especificado usando o gerenciamento fora de banda

PS C:\> Get-SCVMHost -ComputerName "NewHost01" | Stop-SCVMHost -UseOutOfBandChannel -Confirm

Esse comando obtém o objeto host chamado NewHost01 e alimenta o host usando o gerenciamento do OOB. O comando solicita a confirmação antes de prosseguir.

Parâmetros

-Confirm

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

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

-JobVariable

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

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

-PROTipID

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

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

-RunAsynchronously

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

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

-UseOutOfBandChannel

Indica que o canal de gerenciamento fora de banda deve ser usado para executar a operação. Você deve usar esse parâmetro somente quando o computador não responder.

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

-VMHost

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

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

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

-WhatIf

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

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

Saídas

Host

Esse cmdlet retorna um objeto Host.