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.

Syntax

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 pertenezcan a un servicio o a un rol de máquina virtual implementado en el host seguirán siendo funcionales. Sin embargo, al volver a agregar el host o el 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 nueva asociació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 y servicios invitados 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 combinació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 rol de máquina virtual o servicio 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 en $VMRole.

Parámetros

-ComputerTier

Especifica un objeto ComputerTier .

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

-JobVariable

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

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

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-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

-VM

Especifica un objeto de máquina virtual .

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

-VMRole

Especifica un objeto CloudVMRole .

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