Udostępnij za pośrednictwem


Register-SCVirtualMachine

Rejestruje istniejącą maszynę wirtualną w programie VMM, która nie jest obecnie zarejestrowana na platformie wirtualizacji żadnego hosta zarządzanego przez program VMM i nie jest przechowywana w bibliotece programu VMM.

Składnia

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

Opis

Polecenie cmdlet Register-SCVirtualMachine rejestruje istniejącą maszynę wirtualną w programie Virtual Machine Manager (VMM). Zarejestruj hosta, który nie jest obecnie zarejestrowany na platformie wirtualizacji żadnego hosta zarządzanego przez program VMM i nie jest przechowywany w bibliotece programu VMM. Platformy wirtualizacji to Hyper-V, VMware i XenServer. Jeśli pliki maszyn wirtualnych są przechowywane w bibliotece programu VMM, nie trzeba rejestrować maszyny wirtualnej przed wdrożeniem jej na hoście.

Pliki konfiguracji maszyny wirtualnej do zarejestrowania muszą być przechowywane w systemie plików na hoście, na którym ma zostać wdrożona maszyna wirtualna lub przechowywana w magazynie udostępnionym dostępnym dla tego hosta.

Aby zarejestrować maszynę wirtualną dla hosta funkcji Hyper-V, pliki konfiguracji dla tej maszyny wirtualnej muszą być przechowywane w folderze w systemie plików hosta lub w magazynie udostępnionym. Ponadto należy utworzyć eksport maszyny wirtualnej przy użyciu polecenia Eksportuj w konsoli Menedżera funkcji Hyper-V. Ścieżka musi określać folder.

Aby zarejestrować maszynę wirtualną dla hosta VMware ESX, konfiguracja programu VMware musi być przechowywana w systemie plików hosta lub w magazynie udostępnionym. Nie ma oddzielnego kroku eksportu. Ścieżka musi określać folder i plik konfiguracji.

Nie używaj tego polecenia cmdlet do rejestrowania maszyn wirtualnych na hoście XenServer.

Przykłady

Przykład 1: Rejestrowanie istniejącej maszyny wirtualnej na hoście funkcji Hyper-V

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

Pierwsze polecenie pobiera obiekt hosta funkcji Hyper-V o nazwie HyperVHost01, a następnie przechowuje ten obiekt w zmiennej $VMHost.

Drugie polecenie dodaje istniejącą maszynę wirtualną na hoście HVHost02 do programu VMM, określając ścieżkę folderu zawierającego plik konfiguracji maszyny wirtualnej.

Przykład 2. Rejestrowanie istniejącej maszyny wirtualnej na hoście VMware ESX

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

Pierwsze polecenie pobiera obiekt reprezentujący hosta VMware ESX o nazwie ESXHost03 i przechowuje ten obiekt hosta w zmiennej $VMHost.

Drugie polecenie dodaje istniejącą maszynę wirtualną na hoście ESXHost03 do programu VMM, określając ścieżkę pliku konfiguracji maszyny wirtualnej maszyny wirtualnej.

Parametry

-JobGroup

Określa identyfikator serii poleceń uruchamianych jako zestaw tuż przed ostatnim poleceniem zawierającym ten sam identyfikator grupy zadań.

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

-JobVariable

Określa nazwę zmiennej, w której ma być śledzony i przechowywany postęp zadania.

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

-Path

Określa ścieżkę pliku konfiguracji maszyny wirtualnej dla maszyny wirtualnej, którą rejestruje to polecenie cmdlet.

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

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

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

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-VMHost

Określa obiekt hosta maszyny wirtualnej. Program VMM obsługuje hosty funkcji Hyper-V, hosty VMware ESX i hosty Citrix XenServer.

Aby uzyskać więcej informacji na temat każdego typu hosta, zobacz polecenie cmdlet Add-SCVMHost .

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

Dane wyjściowe

VirtualMachine