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

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 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 VMware ESX o un host Citrix XenServer, el objeto host se elimina de la base de datos VMM. VMM no instala un agente en hosts ESX o XenServer.

• Host y servidor de biblioteca. Si este equipo es un host Hyper-V y también es un servidor de biblioteca, este comando quita solo la funcionalidad del host, pero deja la característica de servidor de biblioteca en su lugar. 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 a la vez un host y un servidor de biblioteca.

• Credenciales. Si un host de Hyper-V se une a un dominio de Active Directory, debe proporcionar las credenciales de 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. Al quitar un host, VMM ya no lo administra. Sin embargo, las máquinas virtuales del servidor host no se eliminarán ni se desasociarán del servidor. Las máquinas virtuales en ejecución no se apagan. Aunque VMM ya no administra las máquinas virtuales, no se ven afectadas de ninguna otra manera.
• Expulsió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.

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

Este cmdlet devuelve el objeto en caso de éxito (con la propiedad MarkedForDeletion establecida en $True) o devuelve un mensaje de error en caso de error.

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 pedirle que proporcione un nombre de usuario y una contraseña, y almacena 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 elimina el objeto host almacenado en $VMHost. A medida $Credential que se procesa este comando, proporciona credenciales a Remove-VMHost y el parámetro Confirm le pide que confirme que desea quitar este host 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 de host, excluye los hosts que son nodos en 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 eliminarlos. No se requieren credenciales para eliminar 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 almacena 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, proporciona $Credential credenciales para Remove-VMHost y el parámetro Confirm le pide que confirme que desea quitar estos hosts de 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 activa el parámetro Force para asegurarse de que VMHost03 se quita de la base de datos de VMM. No se necesitan credenciales para esta operación. El parámetro Confirm le pide que confirme que desea eliminar 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.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.