New-LocalGroup

  • Référence
Module:
Microsoft.PowerShell.LocalAccounts

Crée un groupe de sécurité local.

Syntax

New-LocalGroup
   [-Description <String>]
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet New-LocalGroup de commande crée un groupe de sécurité local dans le Gestionnaire de compte de sécurité.

Remarque

Le module Microsoft.PowerShell.LocalAccounts n’est pas disponible dans PowerShell 32 bits sur un système 64 bits.

Exemples

Exemple 1 : Créer un groupe de sécurité

New-LocalGroup -Name "SecurityGroup04"

Cette commande crée un groupe nommé SecurityGroup04.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Spécifie un commentaire pour le groupe. La longueur maximale est de 48 caractères.

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

-Name

Spécifie un nom pour le groupe. La longueur maximale est de 256 caractères.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

Vous pouvez diriger une chaîne vers cette applet de commande.

Sorties

System.Management.Automation.SecurityAccountsManager.LocalGroup

Cette applet de commande retourne un objet LocalGroup représentant le groupe de sécurité créé.

Notes

Windows PowerShell inclut les alias suivants pour New-LocalGroup:

  • nlg

La propriété PrincipalSource est une propriété sur les objets LocalUser, LocalGroup et LocalPrincipal qui décrivent la source de l’objet. Les sources possibles sont les suivantes :

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

PrincipalSource est pris en charge uniquement par Windows 10, Windows Server 2016 et versions ultérieures du système d’exploitation Windows. Pour les versions antérieures, la propriété est vide.