Move-SCVMHost

Référence

Module:: VirtualMachineManager

Déplace un hôte de machine virtuelle géré par VMM d’un groupe hôte vers un autre.

Syntax

Move-SCVMHost
    [-VMHost] <Host>
    -ParentHostGroup <HostGroup>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

L’applet de commande Move-SCVMHost déplace un ou plusieurs hôtes de machine virtuelle gérés par Virtual Machine Manager (VMM) de son groupe hôte actuel vers un nouveau groupe hôte parent. Avant de pouvoir déplacer un hôte, son nouveau groupe hôte parent doit exister.

Si l’hôte est un ordinateur géré par des membres d’un rôle d’utilisateur Self-Service ou administrateur délégué, le déplacement de l’hôte d’un groupe hôte vers un autre peut affecter les rôles qui ont accès à l’hôte ou aux machines virtuelles sur cet hôte.

Exemples

Exemple 1 : Déplacer un seul hôte vers un nouveau groupe hôte parent

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> $NewHG = Get-SCVMHostGroup -Name "NewHostGroup01" 
PS C:\> Move-SCVMHost -VMHost $VMHost -ParentHostGroup $NewHG

La première commande obtient l’hôte nommé VMHost01 et le stocke dans la variable $VMHost.

La deuxième commande obtient l’objet de groupe hôte nommé NewHostGroup et le stocke dans la variable $NewHG.

La dernière commande déplace l’hôte stocké dans la variable $VMHost (VMHost01) vers le groupe hôte stocké dans la variable $NewHG (NewHostGroup).

Exemple 2 : Déplacer tous les hôtes vers un nouveau groupe hôte parent

PS C:\> $AllHosts = Get-SCVMHost  
PS C:\> $NewHG = Get-SCVMHostGroup -Name "NewHostGroup02"
PS C:\> $AllHosts | Move-SCVMHost -ParentHostGroup $NewHG

La première commande obtient tous les objets hôtes et les stocke dans le tableau $AllHosts.

La deuxième commande obtient le groupe hôte nommé NewHostGroup02 et le stocke dans la variable $NewHG.

La dernière commande déplace chaque objet hôte dans le tableau $AllHosts vers le nouveau groupe hôte parent stocké dans la variable $NewHG (NewHostGroup02).

Exemple 3 : Déplacer un ensemble d’hôtes d’un groupe hôte vers un nouveau groupe hôte parent

PS C:\> $SpecificHosts = Get-SCVMHost | where { $_.VMHostGroup -like "*OldGroup*" }
PS C:\> $NewHG = Get-SCVMHostGroup -Name "NewHostGroup03" 
PS C:\> $SpecificHosts | Move-SCVMHost -ParentHostGroup $NewHG

La première commande obtient tous les objets hôtes dont le groupe hôte contient la chaîne « OldGroup » et les stocke dans la variable $SpecificHosts.

La deuxième commande obtient le groupe hôte nommé NewHostGroup03 et le stocke dans la variable $NewHG.

La dernière commande déplace chaque objet hôte stocké dans $SpecificHosts vers le groupe hôte stocké dans la variable $NewHG (NewHostGroup03).

Paramètres

-JobVariable

Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.

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

-ParentHostGroup

Spécifie le groupe hôte parent qui contient un ou plusieurs ordinateurs hôtes, groupes hôtes ou clusters hôtes.

Type:	HostGroup
Aliases:	ParentVMHostGroup
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
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

Host

Cette applet de commande retourne un objet Host .

Notes

Nécessite un objet hôte VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCVMHost .