Remove-SCVMHost

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

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

• Somente servidor host. Se este computador for um host Hyper-V, mas não for também 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 XenServer.

• Host e servidor de biblioteca. Se este computador for um host de Hyper-V e também for um servidor de biblioteca, esse comando removerá apenas a funcionalidade de host, mas deixará o recurso de servidor de biblioteca no lugar. 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 poderá funcionar apenas como um host de máquina virtual no VMM. Ele não pode ser um host e um servidor de biblioteca.

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

Não é necessário fornecer credenciais do Ative 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, quaisquer 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 encerradas. Embora as máquinas virtuais não sejam mais gerenciadas pelo VMM, elas não são afetadas de nenhuma 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 credenciais apropriadas para gerenciar esse host ou quando o servidor VMM não puder mais se comunicar com esse host.

Quando você especifica o parâmetro Force , o VMM não solicita nem 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.

Este cmdlet retorna o objeto após o êxito (com a propriedade MarkedForDeletion definida como $True) ou retorna uma mensagem de erro em caso de falha.

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 armazena as credenciais fornecidas na variável $Credential. As credenciais necessárias para esta operação são uma conta de domínio com direitos de administrador para remover do VMM um servidor host baseado no Windows associado a um domínio do Ative Directory.

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 no $VMHost. À medida que esse comando é processado, $Credential fornece credenciais para Remove-VMHost e o parâmetro Confirm solicita que você confirme que deseja remover esse 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 de host, exclui todos os hosts que são nós em um cluster de hosts, seleciona apenas os objetos que representam hosts VMware ESX, hosts de rede de perímetro ou hosts de domínio não confiáveis e, em seguida, 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 no $Credential.

O último comando obtém todos os objetos de host baseados no Windows associados ao domínio que não fazem parte de um cluster de host e passa os objetos para o cmdlet Remove-VMHost . À medida que esse comando é processado, $Credential fornece suas credenciais para Remove-VMHost e o parâmetro Confirm solicita que você confirme que deseja remover esses hosts 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 ativa 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 esta operação. O parâmetro Confirm solicita que você confirme que deseja remover esse host.

Nota: 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 VMM não puder mais se comunicar com esse host.

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.