Register-SCVirtualMachine
Inscrit une machine virtuelle existante auprès de VMM qui n’est actuellement pas inscrite auprès de la plate-forme de virtualisation d’un hôte géré par VMM et qui n’est pas stockée dans la bibliothèque VMM.
Syntaxe
Default (Par défaut)
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). Enregistrez un hôte qui n’est pas actuellement enregistré auprès de la plate-forme de virtualisation d’un hôte géré par VMM et qui n’est pas stocké dans la bibliothèque VMM. Les plates-formes de virtualisation sont Hyper-V, VMware et XenServer. Si les fichiers de la machine virtuelle sont stockés dans la bibliothèque VMM, vous n’avez pas besoin d’enregistrer la machine virtuelle avant de la déployer sur un hôte.
Les fichiers de configuration de la machine virtuelle à enregistrer doivent être stockés soit dans le système de fichiers de l’hôte sur lequel déployer la machine virtuelle, soit dans 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 du 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 du Gestionnaire de Hyper-V. Le chemin d’accès doit spécifier un dossier.
Pour enregistrer 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 un stockage partagé. Il n’y a pas d’é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 enregistrer 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 récupère 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 récupère 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 qu’ensemble juste avant l’exécution de la commande finale qui inclut le même identificateur de groupe de tâches.
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-JobVariable
Spécifie le nom d’une variable dans laquelle suivre et stocker la progression des tâches.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 enregistre.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PROTipID
Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RunAsynchronously
Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-VMHost
Spécifie un objet hôte de machine virtuelle. VMM prend en charge les hôtes Hyper-V, VMware ESX et Citrix XenServer.
Pour plus d’informations sur chaque type d’hôte, consultez l’applet de commande Add-SCVMHost .
Propriétés du paramètre
| Type: | Host |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.