Register-SCVirtualMachine
Inscrit une machine virtuelle existante auprès de VMM qui n’est actuellement pas inscrite auprès de la plateforme de virtualisation d’un hôte géré par VMM et qui n’est pas stockée dans la bibliothèque VMM.
Syntax
Register-SCVirtualMachine
[-VMHost] <Host>
[-Path] <String>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
L’applet de commande Register-SCVirtualMachine inscrit une machine virtuelle existante auprès de Virtual Machine Manager (VMM). Inscrivez un hôte qui n’est actuellement pas inscrit auprès de la plateforme de virtualisation d’un hôte géré par VMM et qui n’est pas stocké dans la bibliothèque VMM. Les plateformes de virtualisation sont Hyper-V, VMware et XenServer. Si les fichiers de machine virtuelle sont stockés dans la bibliothèque VMM, vous n’avez pas besoin d’inscrire la machine virtuelle avant de le déployer sur un hôte.
Les fichiers de configuration de la machine virtuelle à inscrire doivent être stockés dans le système de fichiers sur l’hôte sur lequel déployer la machine virtuelle ou stockées sur le stockage partagé disponible pour cet hôte.
Pour inscrire une machine virtuelle pour un hôte Hyper-V, les fichiers de configuration de cette machine virtuelle doivent être stockés dans un dossier sur le système de fichiers de l’hôte ou sur le stockage partagé. En outre, vous devez créer une exportation de la machine virtuelle à l’aide de la commande Exporter dans la console Gestionnaire Hyper-V. Le chemin d’accès doit spécifier un dossier.
Pour inscrire une machine virtuelle pour un hôte VMware ESX, la configuration VMware .vmx doit être stockée sur le système de fichiers de l’hôte ou sur le stockage partagé. Il n’existe aucune étape d’exportation distincte. Le chemin d’accès doit spécifier le dossier et le fichier de configuration.
N’utilisez pas cette applet de commande pour inscrire des machines virtuelles sur un hôte XenServer.
Exemples
Exemple 1 : Inscrire une machine virtuelle existante sur un hôte Hyper-V
PS C:\> $VMHost = Get-SCVMHost -ComputerName "HyperVHost01"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "D:\HyperVFolderForVMs"La première commande obtient l’objet hôte Hyper-V nommé HyperVHost01, puis stocke cet objet dans la variable $VMHost.
La deuxième commande ajoute la machine virtuelle existante sur HVHost02 à VMM en spécifiant le chemin d’accès du dossier qui contient le fichier de configuration de la machine virtuelle.
Exemple 2 : Inscrire une machine virtuelle existante sur un hôte VMware ESX
PS C:\> $VMHost = Get-VMHost -ComputerName "ESXHost03"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "[storage1]\VMwareFolderForVMs\MyVM.vmx"La première commande obtient l’objet qui représente un hôte VMware ESX appelé ESXHost03 et stocke cet objet hôte dans la variable $VMHost.
La deuxième commande ajoute une machine virtuelle existante sur ESXHost03 à VMM en spécifiant le chemin d’accès du fichier de configuration de la machine virtuelle de la machine virtuelle.
Paramètres
-JobGroup
Spécifie un identificateur pour une série de commandes qui s’exécutent en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Spécifie le nom d’une variable dans laquelle suivre et stocker la progression du travail.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Spécifie le chemin d’accès du fichier de configuration de la machine virtuelle pour la machine virtuelle que cette applet de commande inscrit.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Spécifie l’ID du conseil d’optimisation des performances et des ressources qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHost
Spécifie un objet ordinateur hôte d’ordinateur virtuel. VMM prend en charge les hôtes Hyper-V, les hôtes VMware ESX et les hôtes Citrix XenServer.
Pour plus d’informations sur chaque type d’hôte, consultez l’applet de commande Add-SCVMHost .
| Type: | Host |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Sorties
VirtualMachine