Stop-SCVMHost

  • Referência
Módulo:
VirtualMachineManager

Interrompe um host gerenciado pelo VMM.

Syntax

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 na banda para desligar o host. Para usar o método OOB, o host deve ser configurado para o gerenciamento de OOB. Para obter informações sobre como configurar as configurações do BMC (Controlador de Gerenciamento de Baseboard) para um host, digite Get-Help Set-SCVMHost -Detailed.

Exemplos

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

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

Esse comando obtém o objeto host chamado NewHost01 e aciona 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 aciona o host usando o gerenciamento OOB. O comando solicita a confirmação antes de prosseguir.

Parâmetros

-Confirm

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

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

-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

-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

-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.

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

-WhatIf

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

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

Saídas

Host

Esse cmdlet retorna um objeto Host .