Condividi tramite


Register-SCVirtualMachine

Registra una macchina virtuale esistente con VMM attualmente non registrata con la piattaforma di virtualizzazione di qualsiasi host gestito da VMM e non viene archiviata nella libreria VMM.

Sintassi

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

Descrizione

Il cmdlet Register-SCVirtualMachine registra una macchina virtuale esistente con Virtual Machine Manager (VMM). Registrare un host attualmente non registrato con la piattaforma di virtualizzazione di qualsiasi host gestito da VMM e non è archiviato nella libreria VMM. Le piattaforme di virtualizzazione sono Hyper-V, VMware e XenServer. Se i file di macchina virtuale vengono archiviati nella libreria VMM, non è necessario registrare la macchina virtuale prima di distribuirla in un host.

I file di configurazione per la macchina virtuale da registrare devono essere archiviati nel file system nell'host in cui distribuire la macchina virtuale o archiviata nell'archiviazione condivisa disponibile per questo host.

Per registrare una macchina virtuale per un host Hyper-V, i file di configurazione per tale macchina virtuale devono essere archiviati in una cartella nel file system dell'host o nell'archiviazione condivisa. È inoltre necessario creare un'esportazione della macchina virtuale usando il comando Esporta nella console di gestione di Hyper-V. Il percorso deve specificare una cartella.

Per registrare una macchina virtuale per un host VMware ESX, è necessario archiviare vMware configuration .vmx nel file system dell'host o nell'archiviazione condivisa. Non esiste un passaggio di esportazione separato. Il percorso deve specificare la cartella e il file di configurazione.

Non usare questo cmdlet per registrare le macchine virtuali in un host XenServer.

Esempio

Esempio 1: Registrare una macchina virtuale esistente in un host Hyper-V

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

Il primo comando ottiene l'oggetto host Hyper-V denominato HyperVHost01 e quindi archivia l'oggetto nella variabile $VMHost.

Il secondo comando aggiunge la macchina virtuale esistente in HVHost02 a VMM specificando il percorso della cartella che contiene il file di configurazione della macchina virtuale.

Esempio 2: Registrare una macchina virtuale esistente in un host VMware ESX

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

Il primo comando ottiene l'oggetto che rappresenta un host VMware ESX denominato ESXHost03 e archivia tale oggetto host nella variabile $VMHost.

Il secondo comando aggiunge una macchina virtuale esistente in ESXHost03 a VMM specificando il percorso del file di configurazione della macchina virtuale della macchina virtuale.

Parametri

-JobGroup

Specifica un identificatore per una serie di comandi eseguiti come set subito prima dell'esecuzione del comando finale che include lo stesso identificatore del gruppo di processi.

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

-JobVariable

Specifica il nome di una variabile in cui tenere traccia e archiviare lo stato del processo.

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

-Path

Specifica il percorso del file di configurazione della macchina virtuale per la macchina virtuale registrata da questo cmdlet.

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

-PROTipID

Specifica l'ID della descrizione per le prestazioni e l'ottimizzazione delle risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.

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

-VMHost

Specifica un oggetto host di macchina virtuale. VMM supporta host Hyper-V, host VMware ESX e host Citrix XenServer.

Per altre informazioni su ogni tipo di host, vedere il cmdlet Add-SCVMHost .

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

Output

VirtualMachine