Remove-SCVMHost

  • Referência
Módulo:
VirtualMachineManager

Remove um host de máquina virtual do VMM.

Syntax

Remove-SCVMHost
      [-VMHost] <Host>
      [-VMMServer <ServerConnection>]
      [-Credential <VMMCredential>]
      [-RemoveHostWithVMs]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCVMHost
      [-VMHost] <Host>
      [-VMMServer <ServerConnection>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-SCVMHost remove um ou mais hosts de máquina virtual do VMM (Virtual Machine Manager). O cmdlet Remove-SCVMHost opera da seguinte maneira:

  • Somente servidor host. Se este computador for um host Hyper-V, mas também não for um servidor de biblioteca, o objeto host será removido do banco de dados do VMM e o software do agente do VMM será desinstalado do servidor host físico.

Se o host for um host VMware ESX ou um host Citrix XenServer, o objeto host será removido do banco de dados do VMM. O VMM não instala um agente em hosts ESX ou hosts XenServer.

  • Host e servidor de biblioteca. Se este computador for um host Hyper-V e também for um servidor de biblioteca, esse comando removerá apenas a funcionalidade do host, mas deixará o recurso do servidor de biblioteca em vigor. Ou seja, o objeto host é removido do banco de dados do VMM, mas o software do agente do VMM não é desinstalado do servidor físico. O objeto do servidor de biblioteca permanece no banco de dados.

Se o host for um host ESX, ele só poderá funcionar como um host de máquina virtual no VMM. Não pode ser um host e um servidor de biblioteca.

  • Credenciais. Se um host Hyper-V for ingressado em um domínio do Active Directory, você deverá fornecer credenciais para uma conta com permissões apropriadas para remover esse computador host do VMM.

Você não precisa fornecer credenciais do Active Directory para remover um host de rede de perímetro, um host ESX ou um host XenServer do VMM.

  • Máquinas virtuais. Quando você remove um host, o host não é mais gerenciado pelo VMM. No entanto, todas as máquinas virtuais no servidor host não serão removidas ou desassociadas do servidor. As máquinas virtuais em execução não são desligadas. Embora as máquinas virtuais não sejam mais gerenciadas pelo VMM, elas não são afetadas de outra forma.
  • Remoção forçada. Você pode usar o parâmetro Force com o cmdlet Remove-SCVMHost para remover um host de máquina virtual do VMM quando não tiver as credenciais apropriadas para gerenciar esse host ou quando o servidor do VMM não puder mais se comunicar com esse host.

Quando você especifica o parâmetro Force , o VMM não solicita ou verifica credenciais, nem o VMM tentará se conectar ao host e desinstalar o agente do VMM. Portanto, o uso do parâmetro Force é recomendado somente ao remover registros de host obsoletos do banco de dados do VMM.

Esse cmdlet retorna o objeto após o sucesso (com a propriedade MarkedForDeletion definida como $True) ou retorna uma mensagem de erro após a falha.

Exemplos

Exemplo 1: remover um host específico ingressado no domínio do VMM

PS C:\> $Credential = Get-Credential
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Credential $Credential -Confirm

O primeiro comando usa o cmdlet Get-Credential para solicitar que você forneça um nome de usuário e senha e armazene as credenciais fornecidas na variável $Credential. As credenciais necessárias para essa operação são uma conta de domínio com direitos de administrador para remover um servidor host baseado no Windows ingressado em um domínio do Active Directory do VMM.

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

O terceiro comando remove o objeto host armazenado em $VMHost. Como esse comando é processado, $Credential fornece credenciais para Remove-VMHost e o parâmetro Confirm solicita que você confirme se deseja remover esse host do VMM.

Exemplo 2: remover todos os hosts que não são nós em um cluster de host do VMM

PS C:\> Get-SCVMHost | where {$_.HostCluster -eq $NULL} | where {$_.VirtualizationPlatform -eq "VMwareESX" -or $_.PerimeterNetworkHost -eq 1 -or $_.NonTrustedDomainHost -eq 1} | Remove-SCVMHost -Confirm
PS C:\> $Credential = Get-Credential
PS C:\> Get-VMHost | where {$_.HostCluster -eq $NULL -and $_.VirtualizationPlatform -ne "VMwareESX" -and $_.PerimeterNetworkHost -eq 0 -and $_.NonTrustedDomainHost -eq 0} | Remove-VMHost -Credential $Credential -Confirm

O primeiro comando obtém todos os objetos host, exclui todos os hosts que são nós em um cluster de host, seleciona apenas os objetos que representam hosts ESX do VMware, hosts de rede de perímetro ou hosts de domínio não confiáveis e remove esses objetos do VMM se você confirmar que deseja removê-los. As credenciais não são necessárias para remover esses hosts.

O segundo comando solicita que você forneça um nome de usuário e senha para uma conta com permissões para remover hosts windows ingressados no domínio do VMM e armazena suas credenciais em $Credential.

O último comando obtém todos os objetos de host baseados no Windows ingressados no domínio que não fazem parte de um cluster de host e passa os objetos para o cmdlet Remove-VMHost . Como esse comando é processado, $Credential fornece suas credenciais para Remove-VMHost e o parâmetro Confirm solicita que você confirme se deseja remover esses hosts do VMM.

Exemplo 3: remover um host específico que você não pode mais acessar do VMM

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Force -Confirm

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

O segundo comando alterna o parâmetro Force para garantir que o VMHost03 seja removido do banco de dados do VMM. As credenciais não são necessárias para essa operação. O parâmetro Confirm solicita que você confirme se deseja remover esse host.

Observação: você pode usar o parâmetro Force para remover um host do VMM quando não tiver as credenciais desse host ou quando o servidor do VMM não puder mais se comunicar com esse host.

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

-Credential

Especifica um objeto de credencial ou, para alguns cmdlets, um objeto de conta Executar como que contém o nome de usuário e a senha de uma conta que tem permissão para executar essa ação. Ou, no caso de Restart-SCJob, tem permissão para concluir uma tarefa reiniciada.

Para obter mais informações sobre o objeto PSCredential , digite Get-Help Get-Credential.

Para obter mais informações sobre contas Executar como, digite Get-Help New-SCRunAsAccount.

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

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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

-RemoveHostWithVMs

Para obter mais informações sobre o objeto PSCredential , digite Get-Help Get-Credential.

Para obter mais informações sobre contas Executar como, digite Get-Help New-SCRunAsAccount.

Type:SwitchParameter
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

-VMMServer

Especifica um objeto de servidor do VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
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