Share via


Register-SCVirtualMachine

Registriert einen vorhandenen virtuellen Computer mit VMM, der derzeit nicht bei 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 bei 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 sie 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, müssen 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 speichert dieses Hostobjekt in der $VMHost Variablen.

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 endgültigen 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 Variablen 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 des virtuellen Computers 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 des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der 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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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