Join-SCVirtualMachine

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

语法

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 对象。

类型:ComputerTier
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-JobVariable

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-OnBehalfOfUser

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-OnBehalfOfUserRole

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

类型:UserRole
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PROTipID

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

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunAsynchronously

指示作业以异步方式运行,以便控件立即返回到命令行界面。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VM

指定 VM 对象。

类型:VM
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-VMRole

指定 CloudVMRole 对象。

类型:CloudVmRole
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False