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.

Syntaxe

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

Description

Le Move-SCVMHostGroup cmdlet 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 hôtes d’un groupe hôte déplacé acquièrent un nouveau chemin d’accès hôte par rapport au groupe hôte racine. La modification de la structure des groupes hôtes peut changer les rôles d’utilisateur en libre-service ou d’administrateur délégué qui ont accès aux hôtes contenus dans les groupes hôtes concernés ou aux machines virtuelles déployées sur ces 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 s’exécute en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobVariable

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ParentHostGroup

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

Type:HostGroup
Alias:ParentVMHostGroup
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMHostGroup

Spécifie un objet de groupe hôte de machine virtuelle.

Type:HostGroup
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 Get-SCVMHostGroup.