Register-SCVirtualMachine

向 VMM 注册现有虚拟机,该虚拟机当前未注册到 VMM 管理的任何主机的虚拟化平台,并且不存储在 VMM 库中。

语法

Register-SCVirtualMachine
        [-VMHost] <Host>
        [-Path] <String>
        [-JobGroup <Guid>]
        [-RunAsynchronously]
        [-PROTipID <Guid>]
        [-JobVariable <String>]
        [<CommonParameters>]

说明

Register-SCVirtualMachine cmdlet 将现有虚拟机注册到 Virtual Machine Manager (VMM) 。 注册当前未注册到 VMM 管理的任何主机的虚拟化平台的主机,并且不存储在 VMM 库中。 虚拟化平台是 Hyper-V、VMware 和 XenServer。 如果虚拟机文件存储在 VMM 库中,则无需在主机上部署虚拟机之前注册虚拟机。

要注册的虚拟机的配置文件必须存储在要部署虚拟机的主机上的文件系统中,或者存储在此主机可用的共享存储中。

若要为 Hyper-V 主机注册虚拟机,该虚拟机的配置文件必须存储在主机文件系统或共享存储上的文件夹中。 此外,必须使用 Hyper-V 管理器控制台中的“导出”命令创建虚拟机的导出。 路径中必须指定文件夹。

若要为 VMware ESX 主机注册虚拟机,VMware 配置 .vmx 必须存储在主机的文件系统或共享存储上。 没有单独的导出步骤。 路径必须指定文件夹和配置文件。

请勿使用此 cmdlet 在 XenServer 主机上注册虚拟机。

示例

示例 1:在 Hyper-V 主机上注册现有虚拟机

PS C:\> $VMHost = Get-SCVMHost -ComputerName "HyperVHost01"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "D:\HyperVFolderForVMs"

第一个命令获取名为 HyperVHost01 的 Hyper-V 主机对象,然后将该对象存储在$VMHost变量中。

第二个命令通过指定包含虚拟机配置文件的文件夹的路径,将 HVHost02 上的现有虚拟机添加到 VMM。

示例 2:在 VMware ESX 主机上注册现有虚拟机

PS C:\> $VMHost = Get-VMHost -ComputerName "ESXHost03" 
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "[storage1]\VMwareFolderForVMs\MyVM.vmx"

第一个命令获取表示名为 ESXHost03 的 VMware ESX 主机的对象,并将该宿主对象存储在$VMHost变量中。

第二个命令通过指定虚拟机虚拟机配置文件的路径,将 ESXHost03 上的现有虚拟机添加到 VMM。

参数

-JobGroup

为一系列命令指定标识符,这些命令在包含相同作业组标识符的最后一个命令之前作为集运行。

Type:Guid
Position:Named
Default value:None
Required:False
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

-Path

指定此 cmdlet 注册的虚拟机的虚拟机配置文件的路径。

Type:String
Position:0
Default value:None
Required:True
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

-VMHost

指定一个虚拟主机对象。 VMM 支持 Hyper-V 主机、VMware ESX 主机和 Citrix XenServer 主机。

有关每种主机类型的详细信息,请参阅 Add-SCVMHost cmdlet。

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

输出

VirtualMachine