Remove-SCVMHost

Referencia

Módulo:: VirtualMachineManager

Quita un host de máquina virtual de 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

El cmdlet Remove-SCVMHost quita uno o varios hosts de máquina virtual de Virtual Machine Manager (VMM). El cmdlet Remove-SCVMHost funciona de la siguiente manera:

Solo servidor host. Si este equipo es un host de Hyper-V pero no es también un servidor de biblioteca, el objeto host se quita de la base de datos VMM y el software del agente VMM se desinstala del servidor host físico.

Si el host es un host de VMware ESX o un host Citrix XenServer, el objeto host se quita de la base de datos VMM. VMM no instala un agente en hosts ESX ni en hosts de XenServer.

Host y servidor de biblioteca. Si este equipo es un host de Hyper-V y también es un servidor de biblioteca, este comando quita solo la funcionalidad del host, pero deja en su lugar la característica del servidor de biblioteca. Es decir, el objeto host se quita de la base de datos VMM, pero el software del agente VMM no se desinstala del servidor físico. El objeto de servidor de biblioteca permanece en la base de datos.

Si el host es un host ESX, solo puede funcionar como host de máquina virtual en VMM. No puede ser host y servidor de biblioteca.

Credenciales. Si un host de Hyper-V está unido a un dominio de Active Directory, debe proporcionar credenciales para una cuenta con los permisos adecuados para quitar ese equipo host de VMM.

No es necesario proporcionar credenciales de Active Directory para quitar un host de red perimetral, un host ESX o un host XenServer de VMM.

Máquinas virtuales. Cuando se quita un host, VMM ya no administra el host. Sin embargo, las máquinas virtuales del servidor host no se quitarán ni desasociarán del servidor. Las máquinas virtuales que se están ejecutando no se apagan. Aunque VMM ya no administra las máquinas virtuales, no se ven afectadas de ninguna otra manera.
Eliminación forzada. Puede usar el parámetro Force con el cmdlet Remove-SCVMHost para quitar un host de máquina virtual de VMM cuando no tenga las credenciales adecuadas para administrar ese host o cuando el servidor VMM ya no pueda comunicarse con ese host.

Cuando se especifica el parámetro Force , VMM no solicita ni comprueba las credenciales, ni VMM intentará conectarse al host y desinstalar el agente VMM. Por lo tanto, solo se recomienda usar el parámetro Force al quitar registros host obsoletos de la base de datos VMM.

Este cmdlet devuelve el objeto cuando se ha realizado correctamente (con la propiedad MarkedForDeletion establecida en $True) o devuelve un mensaje de error tras un error.

Ejemplos

Ejemplo 1: Eliminación de un host específico unido a un dominio de VMM

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

El primer comando usa el cmdlet Get-Credential para solicitarle que proporcione un nombre de usuario y una contraseña y almacene las credenciales proporcionadas en la variable $Credential. Las credenciales necesarias para esta operación son una cuenta de dominio con derechos de administrador para quitar un servidor host basado en Windows unido a un dominio de Active Directory de VMM.

El segundo comando obtiene el objeto host denominado VMHost01 y almacena el objeto en la variable $VMHost.

El tercer comando quita el objeto host almacenado en $VMHost. A medida que se procesa este comando, $Credential proporciona credenciales para Remove-VMHost y el parámetro Confirm le pide que confirme que desea quitar este host de VMM.

Ejemplo 2: Eliminación de todos los hosts que no son nodos de un clúster de hosts de 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

El primer comando obtiene todos los objetos host, excluye los hosts que son nodos de un clúster de hosts, selecciona solo los objetos que representan hosts de VMware ESX, hosts de red perimetral o hosts de dominio que no son de confianza y, a continuación, quita esos objetos de VMM si confirma que desea quitarlos. No son necesarias credenciales para quitar estos hosts.

El segundo comando le pide que proporcione un nombre de usuario y una contraseña para una cuenta con permisos para quitar hosts de Windows unidos a un dominio de VMM y almacene sus credenciales en $Credential.

El último comando obtiene todos los objetos host basados en Windows unidos a un dominio que no forman parte de un clúster de hosts y pasa los objetos al cmdlet Remove-VMHost . A medida que se procesa este comando, $Credential proporciona sus credenciales a Remove-VMHost y el parámetro Confirm le pide que confirme que desea quitar estos hosts de VMM.

Ejemplo 3: Eliminación de un host específico al que ya no se puede acceder desde VMM

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

El primer comando obtiene el objeto host denominado VMHost03 y almacena el objeto en la variable $VMHost.

El segundo comando cambia en el parámetro Force para asegurarse de que VMHost03 se quita de la base de datos VMM. Las credenciales son obligatorias para esta operación. El parámetro Confirm le pide que confirme que desea quitar este host.

Nota: Puede usar el parámetro Force para quitar un host de VMM cuando no tenga las credenciales de ese host o cuando el servidor VMM ya no pueda comunicarse con ese host.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Credential

Especifica un objeto de credencial o, para algunos cmdlets, un objeto de cuenta de ejecución que contiene el nombre de usuario y la contraseña de una cuenta que tiene permiso para realizar esta acción. O bien, en el caso de Restart-SCJob, tiene permiso para completar una tarea reiniciada.

Para obtener más información sobre el objeto PSCredential , escriba Get-Help Get-Credential.

Para obtener más información sobre las cuentas de ejecución, escriba Get-Help New-SCRunAsAccount.

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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

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

-PROTipID

Especifica el identificador de la sugerencia rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

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

-RemoveHostWithVMs

Para obtener más información sobre el objeto PSCredential , escriba Get-Help Get-Credential.

Para obtener más información sobre las cuentas de ejecución, escriba Get-Help New-SCRunAsAccount.

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

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

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

-VMHost

Especifica un objeto host de máquina virtual. VMM admite hosts de Hyper-V, hosts de VMware ESX y hosts de Citrix XenServer.

Para obtener más información sobre cada tipo de host, consulte el cmdlet Add-SCVMHost .

Type:	Host
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMMServer

Especifica un objeto de servidor VMM.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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