Remove-SCVMHost

Módulo:

VirtualMachineManager

Remove um hospedeiro 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 anfitriões de máquinas virtuais do Virtual Machine Manager (VMM). O cmdlet Remove-SCVMHost funciona da seguinte forma:

• Apenas servidor de anfitrião. Se este computador for um anfitrião Hiper-V, mas não for também um servidor de biblioteca, o objeto anfitrião é removido da base de dados VMM e o software do agente VMM é desinstalado do servidor de anfitrião físico.

Se o anfitrião for um anfitrião VMware ESX ou um anfitrião Citrix XenServer, o objeto anfitrião é removido da base de dados VMM. A VMM não instala um agente em anfitriões ESX ou em anfitriões XenServer.

• Servidor de anfitrião e biblioteca. Se este computador é um anfitrião Hiper-V e é também um servidor de biblioteca, este comando remove apenas a funcionalidade do anfitrião, mas deixa a funcionalidade do servidor da biblioteca no lugar. Ou seja, o objeto anfitrião é removido da base de dados VMM, mas o software do agente VMM não é desinstalado do servidor físico. O objeto do servidor da biblioteca permanece na base de dados.

Se o anfitrião for um anfitrião ESX, só pode funcionar como um hospedeiro de máquina virtual em VMM. Não pode ser um hospedeiro e um servidor de biblioteca.

• Credenciais. Se um anfitrião Hiper-V estiver ligado a um domínio ative directory, deve fornecer credenciais para uma conta com permissões apropriadas para remover esse computador anfitrião do VMM.

Não é necessário fornecer credenciais de Ative Directory para remover um hospedeiro de rede de perímetro, um anfitrião ESX ou um anfitrião XenServer da VMM.

• Máquinas Virtuais. Quando remove um hospedeiro, o hospedeiro já não é gerido por VMM. No entanto, quaisquer máquinas virtuais no servidor anfitrião não serão removidas ou dissociadas do servidor. As máquinas virtuais em funcionamento não estão desligadas. Embora as máquinas virtuais já não sejam geridas por VMM, não são afetadas de outra forma.
• Remoção forçada. Pode utilizar o parâmetro Force com o cmdlet Remove-SCVMHost para remover um hospedeiro de máquina virtual do VMM quando não tiver credenciais adequadas para gerir esse hospedeiro ou quando o servidor VMM já não consegue comunicar com esse hospedeiro.

Quando especificar o parâmetro Force , o VMM não pede nem verifica as credenciais, nem o VMM tentará ligar ao hospedeiro e desinstalar o agente VMM. Assim, a utilização do parâmetro Force só é recomendada quando se removem registos hospedeiros velhos da base de dados VMM.

Este cmdlet devolve o objeto após o sucesso (com a propriedade marcada para $True) ou devolve uma mensagem de erro após falha.

Exemplos

Exemplo 1: Remover um hospedeiro específico de 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 utiliza o cmdlet Get-Credential para lhe solicitar que forneça um nome de utilizador e palavra-passe 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 um servidor anfitrião baseado no Windows, ligado a um domínio de Diretório Ativo da VMM.

O segundo comando recebe o objeto anfitrião chamado VMHost01 e armazena o objeto na variável $VMHost.

O terceiro comando remove o objeto hospedeiro armazenado em $VMHost. Como este comando é processado, $Credential fornece credenciais para Remove-VMHost, e o parâmetro Confirmar pede-lhe para confirmar que deseja remover este hospedeiro do VMM.

Exemplo 2: Remova todos os anfitriões que não sejam nós num cluster de anfitriões 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 recebe todos os objetos hospedeiros, exclui quaisquer anfitriões que sejam nós num cluster anfitrião, seleciona apenas os objetos que representam os anfitriões VMware ESX, os anfitriões da rede de perímetro ou os anfitriões de domínio não confiáveis, e depois remove esses objetos do VMM se confirmar que os pretende remover. As credenciais não são necessárias para remover estes anfitriões.

O segundo comando solicita-lhe que forneça um nome de utilizador e uma palavra-passe para uma conta com permissões para remover anfitriões windows ligados ao domínio do VMM e armazena as suas credenciais em $Credential.

O último comando obtém todos os objetos hospedeiros baseados no domínio do Windows que não fazem parte de um cluster de hospedeiro e passa os objetos para o cmdlet Remove-VMHost . Como este comando é processado, $Credential fornece as suas credenciais para Remove-VMHost, e o parâmetro Confirmar pede-lhe que confirme que pretende remover estes anfitriões do VMM.

Exemplo 3: Remova um anfitrião específico que já não pode aceder a partir de VMM

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

O primeiro comando recebe o objeto anfitrião chamado VMHost03 e armazena o objeto na variável $VMHost.

O segundo comando liga o parâmetro Force para garantir que o VMHost03 seja removido da base de dados VMM. Não são necessárias credenciais para esta operação. O parâmetro Confirmar solicita-lhe que confirme que deseja remover este hospedeiro.

Nota: Pode utilizar o parâmetro Force para remover um hospedeiro do VMM quando não tiver as credenciais para esse hospedeiro ou quando o servidor VMM já não consegue comunicar com esse hospedeiro.

Parâmetros

-Confirm

Solicita a 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 credencial ou, para alguns cmdlets, um objeto de conta Run As que contém o nome de utilizador e a palavra-passe de uma conta que tem permissão para realizar esta ação. Ou, no caso do Restart-SCJob, tem permissão para completar uma tarefa reiniciada.

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

Para mais informações sobre Run As accounts, escreva 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 funcionar sem pedir confirmação do utilizador.

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

-JobVariable

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

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RemoveHostWithVMs

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

Para mais informações sobre Run As accounts, escreva 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 funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-VMHost

Especifica um objeto hospedeiro de máquina virtual. A VMM suporta anfitriões Hiper-V, anfitriões VMware ESX e anfitriões Citrix XenServer.

Para obter mais informações sobre cada tipo de hospedeiro, 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 VMM.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Ligações Relacionadas

• Add-SCVMHost
• Disable-SCVMHost
• Enable-SCVMHost
• Get-SCVMHost
• Move-SCVMHost
• New-SCVMHost
• Read-SCVMHost
• Register-SCVMHost
• Repair-SCVMHost
• Restart-SCVMHost
• Set-SCVMHost
• Start-SCVMHost
• Stop-SCVMHost