Partager via

Move-SCVMHostGroup

  • Référence
Module:
VirtualMachineManager

Déplace un groupe hôte de l’emplacement actuel vers un nouvel emplacement sous un autre parent de groupe hôte.

Syntax

Move-SCVMHostGroup
    [-VMHostGroup] <HostGroup>
    [-JobGroup <Guid>]
    -ParentHostGroup <HostGroup>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

L’applet de commande Move-SCVMHostGroup déplace un ou plusieurs objets de groupe hôte, qui contiennent des hôtes de machine virtuelle gérés par Virtual Machine Manager (VMM), de l’emplacement actuel à un nouvel emplacement sous un autre parent de groupe hôte. Vous pouvez placer des groupes hôtes sous le groupe hôte racine par défaut (Tous les hôtes) ou sous tout autre groupe hôte créé par un administrateur.

Tous les ordinateurs hôtes au sein d’un groupe hôte déplacé obtiennent un nouveau chemin d’accès par rapport au groupe hôte racine. Le fait de modifier la structure des groupes hôtes peut déterminer les rôles d’utilisateurs Utilisateur libre-service ou Administrateur délégué ayant effectivement accès aux ordinateurs hôtes contenus dans les groupes hôtes affectés ou aux ordinateurs virtuels déployés sur ces ordinateurs hôtes.

Exemples

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

PS C:\> $OldHostGroup = Get-SCVMHostGroup -Name "OldHostGroup"
PS C:\> $NewHostGroup = Get-SCVMHostGroup -Name "NewHostGroup"
PS C:\> Move-SCVMHostGroup -VMHostGroup $OldHostGroup -ParentHostGroup $NewHostGroup

La première commande obtient le groupe hôte nommé OldHostGroup et stocke l’objet de groupe hôte dans la variable $OldHostGroup.

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

La dernière commande déplace le groupe hôte stocké dans la variable $OldHostGroup (OldHostGroup) vers un emplacement sous son nouveau groupe hôte parent, stocké dans la variable $NewHostGroup.

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

PS C:\> $AllGroups = Get-SCVMHostGroup
PS C:\> $HostGroup = New-SCVMHostGroup -Name "NewHostGroup01" 
PS C:\> $AllGroups | Move-SCVMHostGroup -ParentHostGroup $HostGroup

La première commande obtient tous les objets de groupe hôte et les stocke dans le tableau $AllGroups. Cela inclut le groupe hôte parent par défaut (tous les hôtes).

La deuxième commande crée un objet de groupe hôte nommé NewHostGroup01 et le stocke dans la variable $HostGroup.

La dernière commande transmet chaque objet de groupe hôte stocké dans la variable $AllGroups à l’applet de commande Move-VMHostGroup , qui déplace chaque objet de groupe hôte vers l’emplacement stocké dans la variable $HostGroup, à l’exception de Tous les hôtes, car tous les hôtes sont le groupe hôte parent par défaut et ne peuvent pas être déplacés.

Paramètres

-JobGroup

Spécifie un identificateur pour une série de commandes qui seront exécutées ensemble juste avant que la commande finale qui comprend le même identificateur de groupe de travaux soit exécutée.

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

-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:False
Accept wildcard characters: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.

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

-VMHostGroup

Spécifie un objet groupe hôte d'ordinateurs virtuels.

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

Sorties

HostGroup

Cette applet de commande retourne un objet HostGroup .

Notes

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