Delen via


Register-SCVirtualMachine

Registreert een bestaande virtuele machine bij VMM die momenteel niet is geregistreerd bij het virtualisatieplatform van een host die wordt beheerd door VMM en die niet is opgeslagen in de VMM-bibliotheek.

Syntax

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

Description

De cmdlet Register-SCVirtualMachine registreert een bestaande virtuele machine met Virtual Machine Manager (VMM). Registreer een host die momenteel niet is geregistreerd bij het virtualisatieplatform van een host die wordt beheerd door VMM en die niet is opgeslagen in de VMM-bibliotheek. Virtualisatieplatformen zijn Hyper-V, VMware en XenServer. Als bestanden van virtuele machines zijn opgeslagen in de VMM-bibliotheek, hoeft u de virtuele machine niet te registreren voordat u deze op een host implementeert.

De configuratiebestanden voor de virtuele machine die moeten worden geregistreerd, moeten worden opgeslagen in het bestandssysteem op de host waarop de virtuele machine moet worden geïmplementeerd of opgeslagen in gedeelde opslag die beschikbaar is voor deze host.

Als u een virtuele machine wilt registreren voor een Hyper-V-host, moeten de configuratiebestanden voor die virtuele machine worden opgeslagen in een map op het bestandssysteem van de host of op gedeelde opslag. Daarnaast moet u een export van de virtuele machine maken met behulp van de opdracht Exporteren in de Hyper-V-beheerconsole. Het pad moet een map opgeven.

Als u een virtuele machine wilt registreren voor een VMware ESX-host, moet de VMware-configuratie .vmx worden opgeslagen in het bestandssysteem van de host of op gedeelde opslag. Er is geen afzonderlijke exportstap. Het pad moet de map en het configuratiebestand opgeven.

Gebruik deze cmdlet niet om virtuele machines te registreren op een XenServer-host.

Voorbeelden

Voorbeeld 1: Een bestaande virtuele machine registreren op een Hyper-V-host

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

Met de eerste opdracht wordt het Hyper-V-hostobject met de naam HyperVHost01 opgehaald en wordt dat object vervolgens opgeslagen in de variabele $VMHost.

Met de tweede opdracht wordt de bestaande virtuele machine op HVHost02 toegevoegd aan VMM door het pad op te geven van de map die het configuratiebestand van de virtuele machine bevat.

Voorbeeld 2: Een bestaande virtuele machine registreren op een VMware ESX-host

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

Met de eerste opdracht wordt het object opgehaald dat een VMware ESX-host met de naam ESXHost03 vertegenwoordigt en dat hostobject opslaat in de $VMHost variabele.

Met de tweede opdracht wordt een bestaande virtuele machine op ESXHost03 toegevoegd aan VMM door het pad op te geven van het configuratiebestand van de virtuele machine.

Parameters

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

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

-JobVariable

Hiermee geeft u de naam van een variabele waarin de voortgang van de taak moet worden bijgehouden en opgeslagen.

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

-Path

Hiermee geeft u het pad van het configuratiebestand van de virtuele machine op voor de virtuele machine die met deze cmdlet wordt geregistreerd.

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

-PROTipID

Hiermee geeft u de id op van de tip prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

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

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

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

-VMHost

Hiermee geeft u een hostobject voor de virtuele machine op. VMM ondersteunt Hyper-V-hosts, VMware ESX-hosts en Citrix XenServer-hosts.

Zie de cmdlet Add-SCVMHost voor meer informatie over elk type host.

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

Uitvoerwaarden

VirtualMachine