Register-SCVirtualMachine
向 VMM 註冊現有的虛擬機器,該虛擬機器目前未向 VMM 管理之任何主機的虛擬化平臺註冊,而且不會儲存在 VMM 程式庫中。
Syntax
Register-SCVirtualMachine
[-VMHost] <Host>
[-Path] <String>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
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 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 PRO 秘訣。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
表示作業會以非同步方式執行,讓控制項立即返回命令殼層。
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