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