Partager via

Remove-SCVMHostGroup

  • Référence
Module:
VirtualMachineManager

Supprime un groupe hôte de VMM.

Syntaxe

Remove-SCVMHostGroup
      [-VMHostGroup] <HostGroup>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-SCVMHostGroup supprime un ou plusieurs objets de groupe hôte de la base de données Virtual Machine Manager (VMM). Un groupe hôte ne peut pas être supprimé s’il est associé à un cloud privé, s’il y a des hôtes qui lui sont affectés ou si son groupe hôte enfant lui est affecté. Cette applet de commande supprime les groupes hôtes enfants si le groupe hôte et ses groupes hôtes enfants ne contiennent aucun hôte de machine virtuelle.

Cette applet de commande retourne l’objet en cas de réussite (avec la propriété MarkedForDeletion définie sur True) ou retourne un message d’erreur en cas d’échec.

Exemples

Exemple 1 : Supprimer le groupe hôte spécifié

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup02"
PS C:\> Remove-SCVMHostGroup -VMHostGroup $HostGroup

La première commande obtient le groupe hôte nommé HostGroup02 et le stocke dans la variable $HostGroup.

La deuxième commande supprime l’objet de groupe hôte stocké dans la variable $HostGroup.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
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

-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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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

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.