Register-SCVirtualMachine
Registriert einen vorhandenen virtuellen Computer mit VMM, der derzeit nicht mit der Virtualisierungsplattform eines von VMM verwalteten Hosts registriert ist und nicht in der VMM-Bibliothek gespeichert ist.
Syntax
Register-SCVirtualMachine
[-VMHost] <Host>
[-Path] <String>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Register-SCVirtualMachine registriert einen vorhandenen virtuellen Computer mit Virtual Machine Manager (VMM). Registrieren Sie einen Host, der derzeit nicht mit der Virtualisierungsplattform eines von VMM verwalteten Hosts registriert ist und nicht in der VMM-Bibliothek gespeichert ist. Virtualisierungsplattformen sind Hyper-V, VMware und XenServer. Wenn virtuelle Computerdateien in der VMM-Bibliothek gespeichert sind, müssen Sie den virtuellen Computer nicht registrieren, bevor Sie es auf einem Host bereitstellen.
Die Konfigurationsdateien für den virtuellen Computer, der registriert werden soll, müssen entweder im Dateisystem auf dem Host gespeichert werden, auf dem der virtuelle Computer bereitgestellt oder auf freigegebenem Speicher gespeichert wird, der für diesen Host verfügbar ist.
Um einen virtuellen Computer für einen Hyper-V-Host zu registrieren, muss die Konfigurationsdateien für diesen virtuellen Computer in einem Ordner im Dateisystem des Hosts oder im freigegebenen Speicher gespeichert werden. Darüber hinaus müssen Sie einen Export des virtuellen Computers mithilfe des Befehls "Exportieren" in der Hyper-V-Manager-Konsole erstellen. Im Pfad muss ein Ordner angegeben sein.
Um einen virtuellen Computer für einen VMware ESX-Host zu registrieren, muss die VMware-Konfiguration .vmx im Dateisystem des Hosts oder im freigegebenen Speicher gespeichert werden. Es gibt keinen separaten Exportschritt. Im Pfad müssen der Ordner und die Konfigurationsdatei angegeben sein.
Verwenden Sie dieses Cmdlet nicht, um virtuelle Computer auf einem XenServer-Host zu registrieren.
Beispiele
Beispiel 1: Registrieren eines vorhandenen virtuellen Computers auf einem Hyper-V-Host
PS C:\> $VMHost = Get-SCVMHost -ComputerName "HyperVHost01"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "D:\HyperVFolderForVMs"
Der erste Befehl ruft das Hyper-V-Hostobjekt namens HyperVHost01 ab und speichert dieses Objekt dann in der $VMHost Variablen.
Der zweite Befehl fügt den vorhandenen virtuellen Computer auf HVHost02 zu VMM hinzu, indem er den Pfad des Ordners angibt, der die Konfigurationsdatei des virtuellen Computers enthält.
Beispiel 2: Registrieren eines vorhandenen virtuellen Computers auf einem VMware ESX-Host
PS C:\> $VMHost = Get-VMHost -ComputerName "ESXHost03"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "[storage1]\VMwareFolderForVMs\MyVM.vmx"
Der erste Befehl ruft das Objekt ab, das einen VMware ESX-Host namens ESXHost03 darstellt und dieses Hostobjekt in der $VMHost Variablen speichert.
Der zweite Befehl fügt einen vorhandenen virtuellen Computer auf ESXHost03 zu VMM hinzu, indem er den Pfad der virtuellen Computerkonfigurationsdatei des virtuellen Computers angibt.
Parameter
-JobGroup
Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem letzten Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Gibt den Namen einer Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert werden soll.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Gibt den Pfad der Konfigurationsdatei für den virtuellen Computer an, den dieses Cmdlet registriert.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHost
Gibt ein Hostobjekt für virtuelle Maschinen an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.
Weitere Informationen zu jedem Hosttyp finden Sie im Add-SCVMHost-Cmdlet .
Type: | Host |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Ausgaben
VirtualMachine