Register-SCVirtualMachine

参考

模块:: VirtualMachineManager

将现有虚拟机注册到 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