Partager via

New-SCVMHostGroup

  • Référence
Module:
VirtualMachineManager

Crée un groupe hôte qui peut contenir des ordinateurs hôtes de machine virtuelle, d’autres groupes hôtes ou des clusters hôtes.

Syntaxe

New-SCVMHostGroup
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-ParentHostGroup <HostGroup>]
   [-EnableUnencryptedFileTransfer <Boolean>]
   [-InheritNetworkSettings <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

La cmdlet New-SCVMHostGroup crée un objet de groupe hôte pouvant contenir des ordinateurs hôtes sur lesquels une ou plusieurs machines virtuelles sont déployées, d’autres groupes hôtes ou clusters hôtes.

Virtual Machine Manager (VMM) fournit un groupe hôte parent par défaut appelé Tous les hôtes, auquel vous pouvez ajouter des groupes hôtes enfants. Un nouveau groupe hôte est vide jusqu’à ce que vous déplacez des hôtes dans celui-ci ou créez un ou plusieurs groupes hôtes enfants sous celui-ci. Les groupes hôtes sont organisés en arborescence hiérarchique et personnalisable. Dans l’arborescence du groupe hôte, le parent d’un nouveau groupe hôte est le groupe hôte racine par défaut (Tous les hôtes) ou un groupe hôte créé par l’utilisateur.

Un groupe hôte peut être un conteneur parent pour l’un des éléments suivants :

  • Un hôte ou un ensemble d’hôtes
  • Groupe hôte ou ensemble de groupes hôtes et hôtes au sein de ces groupes hôtes
  • Un cluster hôte et des hôtes (nœuds) au sein de ce cluster hôte

Les hôtes contenus dans un groupe hôte ont une propriété de chemin d’accès hôte qui affiche l’emplacement de cet hôte dans la hiérarchie du groupe hôte, comme illustré dans le tableau suivant :

Chemin d’accès au nom

  • Tous les hôtes
  • ChildHostGroup01 All Hosts\ChildHostGroup01
  • ChildHostGroup02 Tous les hôtes\ChildHostGroup02
  • Nouveau centre de données tous les hôtes\Nouveau centre de données
  • nested1 All Hosts\New Datacenter\nested01
  • nested2 All Hosts\New Datacenter\nested\nested02

Exemples

Exemple 1 : Créer un groupe hôte sous le groupe hôte racine

PS C:\> New-SCVMHostGroup -VMMServer "VMMServer01.Contoso.com" -Name "HostGroup01"

Cette commande crée un groupe hôte nommé HostGroup01 sur VMMServer01 dans le domaine Contoso.com. Par défaut, VMM place ce groupe hôte sous le groupe hôte racine, qui est appelé Tous les hôtes.

Exemple 2 : Créer un groupe hôte sous un groupe hôte parent spécifié

PS C:\> $ParentGroup = Get-SCVMHostGroup -Name "HostGroup01" 
PS C:\> New-SCVMHostGroup -Name "ChildGroup01" -ParentHostGroup $ParentGroup

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

La deuxième commande crée un groupe hôte nommé ChildGroup01 et le place sous le groupe hôte parent stocké dans la variable $ParentGroup.

Paramètres

-Description

Spécifie une description pour le groupe hôte.

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

-EnableUnencryptedFileTransfer

Indique, lorsqu’il est défini sur True, que les transferts de fichiers réseau ne nécessitent pas de chiffrement. L’autorisation de transfert de fichiers réseau non chiffrés peut améliorer les performances si ni l’hôte source ni l’hôte de destination ne nécessitent le chiffrement.

Utilisez ce paramètre pour :

  • Activez les transferts de fichiers non chiffrés vers ou hors de la bibliothèque.
  • Activez les transferts de fichiers non chiffrés vers, hors ou au sein d’un groupe hôte.
Type:Boolean
Alias:AllowUnencryptedTransfers
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InheritNetworkSettings

Indique, lorsqu’il est défini sur $True, que les paramètres réseau d’un groupe hôte auront les mêmes valeurs que celles spécifiées pour son parent.

Type:Boolean
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

-Name

Spécifie le nom d’un objet VMM.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
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:False
Accepter l'entrée de pipeline:True
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

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
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.