Compartir a través de

Join-SCVirtualMachine

  • Referencia
Módulo:
VirtualMachineManager

Vuelve a asociar una máquina virtual huérfana a su rol de servicio o máquina virtual.

Sintaxis

Join-SCVirtualMachine
    [-VM] <VM>
    -ComputerTier <ComputerTier>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Join-SCVirtualMachine
    [-VM] <VM>
    -VMRole <CloudVmRole>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

El cmdlet Join-SCVirtualMachine vuelve a asociar una máquina virtual huérfana a su rol de servicio o máquina virtual.

Cuando se quita un host o clúster de Virtual Machine Manager (VMM), las máquinas virtuales que pertenecen a un servicio o un rol de máquina virtual implementado en el host siguen siendo funcionales. Sin embargo, al volver a agregar el host o clúster a VMM, las máquinas virtuales se vuelven huérfanas en el sentido de que ya no tienen ninguna asociación con su rol de servicio o máquina virtual.

Puede usar este cmdlet para restaurar la asociación entre una máquina virtual y su rol de servicio o máquina virtual. El cmdlet Join-SCVirtualMachine ejecuta una tarea de reasignación en VMM que realiza un conjunto de validaciones que ayudan a confirmar la compatibilidad de la máquina virtual con la plantilla de servicio.

Cuando el cmdlet valida la compatibilidad de la máquina virtual con la plantilla de nivel de equipo, se realizan operaciones de solo base de datos y no se realizan ajustes en la máquina virtual. Se supone que la máquina virtual se está ejecutando y que todas las aplicaciones invitadas y los servicios que se ejecutan en ella están intactos.

El nivel de equipo al que desea unir la máquina virtual debe ejecutarse por debajo de su recuento máximo de instancias. El dominio de actualización de la operación de unión es similar a un escalado horizontal.

Para obtener los mejores resultados, use este cmdlet con una máquina virtual que originalmente formaba parte de una implementación de roles de servicio o máquina virtual y no se modificó.

Ejemplos

Ejemplo 1: Unión de una máquina virtual huérfana a un nivel de servicio

PS C:\> $VM = Get-SCVirtualMachine -Name "PS-Web-001" 
PS C:\> $CT = Get-SCComputerTier -Name "MyService-WebTier" 
PS C:\> Join-SCVirtualMachine -VM $VM -ComputerTier $CT

El primer comando obtiene la máquina virtual denominada PS-Web-001 y, a continuación, la almacena en la variable $VM.

El segundo comando obtiene el nivel de equipo denominado MyService-WebTier y, a continuación, lo almacena en la variable $CT.

El último comando combina la máquina virtual en $VM al nivel de equipo en $CT.

Ejemplo 2: Unión de una máquina virtual huérfana a un rol de máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "PS-Web-001" 
PS C:\> $VmRole = Get-CloudResource -Name "ContosoShop" 
PS C:\> Join-SCVirtualMachine -VM $VM -VMRole $VmRole

El primer comando obtiene la máquina virtual denominada PS-Web-001 y, a continuación, la almacena en la variable $VM.

El segundo comando obtiene el recurso en la nube denominado ContosoShop y, a continuación, lo almacena en la variable $VmRole.

El último comando combina la máquina virtual en $VM al rol de $VMRole.

Parámetros

-ComputerTier

Especifica un objeto ComputerTier.

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

-JobVariable

Especifica una variable en la que se realiza un seguimiento del progreso del trabajo y se almacena.

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

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.

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

-OnBehalfOfUserRole

Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole. Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.

Tipo:UserRole
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

-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

-VM

Especifica un objeto de máquina virtual.

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

-VMRole

Especifica un objeto CloudVMRole.

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