New-VMGroup
New-VMGroup
Creates a virtual machine group.
Syntaxe
Parameter Set: Default
New-VMGroup [-Name] <String> [-GroupType] <GroupType> {VMCollectionType | ManagementCollectionType} [[-Id] <Guid> ] [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [ <CommonParameters>]
Description détaillée
The New-VMGroup cmdlet creates a virtual machine group.
Paramètres
-CimSession<CimSession[]>
Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tels que le résultat d'une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-ComputerName<String[]>
Specifies one or more Hyper-V hosts that run this cmdlet. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Credential<PSCredential[]>
Specifies one or more user accounts that have permission to perform this action. The default is the current user.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-GroupType<GroupType>
Specifies the type of group that this cmdlet creates. Les valeurs acceptables pour ce paramètre sont les suivantes : ManagementCollectionType and VMCollectionType.
Alias |
none |
Requis ? |
true |
Position ? |
2 |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Id<Guid>
Specifies the unique ID of the group that this cmdlet creates.
Alias |
none |
Requis ? |
false |
Position ? |
3 |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Name<String>
Specifies the name for the group that this cmdlet creates.
Alias |
none |
Requis ? |
true |
Position ? |
1 |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.
Sorties
Le type de sortie correspond au type des objets que l'applet de commande émet.
- Microsoft.HyperV.PowerShell.VMGroup
Exemples
Example 1: Create a group to contain virtual machines
This command creates a virtual machine group named CollectionGroup07 of type VMCollectionType. This group can contain collections of virtual machines.
PS C:\> New-VMGroup -Name "CollectionGroup07" -GroupType VMCollectionType
Example 2: Create a group to contain groups of virtual machines
This command creates a virtual machine group named ManagementCollectionGroup03 of type ManagementCollectionType. This group can contain collections of other groups.
PS C:\> New-VMGroup -Name "ManagementCollectionGroup03" -GroupType ManagementCollectionType