Compartir a través de

Remove-SCVMHost

  • Referencia
Módulo:
VirtualMachineManager

Quita un host de máquina virtual de VMM.

Sintaxis

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 de 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 de Citrix XenServer, el objeto host se quita de la base de datos VMM. VMM no instala un agente en hosts ESX ni en hosts 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 la característica del 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 tanto un host como un 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 en ejecución 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 de para quitar un host de máquina virtual de VMM cuando no tenga credenciales adecuadas para administrar ese host o cuando el servidor VMM ya no pueda comunicarse con ese host.

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

Este cmdlet devuelve el objeto tras éxito (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-VMHosty 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 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 host, excluye todos los hosts que son nodos de un clúster host, 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 se requieren 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 host y pasa los objetos al cmdlet remove-VMHost . A medida que se procesa este comando, $Credential proporciona sus credenciales para Remove-VMHosty 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 el parámetro Force para asegurarse de que VMHost03 se quita de la base de datos VMM. Las credenciales no son necesarias 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 pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 de PSCredential, escriba Get-Help Get-Credential.

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

Tipo:VMMCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

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

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveHostWithVMs

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

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Host
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMMServer

Especifica un objeto de servidor VMM.

Tipo:ServerConnection
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False