Join-SCVirtualMachine

参考

模块:: VirtualMachineManager

将孤立的虚拟机重新关联到其服务或虚拟机角色。

语法

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

说明

Join-SCVirtualMachine cmdlet 将孤立虚拟机重新关联到其服务或虚拟机角色。

从 Virtual Machine Manager 中删除主机或群集 (VMM) 时，属于服务或部署在主机上的虚拟机角色的任何虚拟机都将保持正常运行。但是，在将主机或群集添加回 VMM 时，虚拟机变得孤立，因为虚拟机不再与服务或虚拟机角色有任何关联。

可以使用此 cmdlet 还原虚拟机与其服务或虚拟机角色之间的关联。 Join-SCVirtualMachine cmdlet 在 VMM 上运行重新关联任务，该任务执行一组验证，帮助确认虚拟机与服务模板的兼容性。

当 cmdlet 验证虚拟机与计算机层模板的兼容性时，将执行仅限数据库的操作，并且不会对虚拟机做出任何调整。假定虚拟机正在运行，并且其上运行的所有来宾应用程序和服务都完好无损。

要加入虚拟机的计算机层必须运行在其最大实例计数以下。加入操作的升级域类似于横向扩展。

为了获得最佳效果，将此 cmdlet 与最初属于服务或虚拟机角色部署的虚拟机配合使用，并且未修改。

示例

示例 1：将孤立虚拟机加入服务层

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

第一个命令获取名为 PS-Web-001 的虚拟机，然后将其存储在$VM变量中。

第二个命令获取名为 MyService-WebTier 的计算机层，然后将其存储在$CT变量中。

最后一个命令将$VM中的虚拟机联接到$CT中的计算机层。

示例 2：将孤立虚拟机加入虚拟机角色

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

第一个命令获取名为 PS-Web-001 的虚拟机，然后将其存储在$VM变量中。

第二个命令获取名为 ContosoShop 的云资源，然后将其存储在$VmRole变量中。

最后一个命令将$VM中的虚拟机联接到$VMRole中的角色。

参数

-ComputerTier

指定 ComputerTier 对象。

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

-JobVariable

指定在其中跟踪和存储作业进度的变量。

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

-OnBehalfOfUser

指定用户名。此 cmdlet 代表此参数指定的用户运行。

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

-OnBehalfOfUserRole

指定用户角色。若要获取用户角色，请使用 Get-SCUserRole cmdlet。此 cmdlet 代表此参数指定的用户角色运行。

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

-PROTipID

指定触发此操作 (PRO 提示) 的性能和资源优化提示的 ID。此参数允许审核 PRO 提示。

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

-RunAsynchronously

指示作业异步运行，以便控件立即返回到命令 shell。

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

-VM

指定 VM 对象。

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

-VMRole

指定 CloudVMRole 对象。

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