Partager via

New-LocalGroup

Module:
Microsoft.PowerShell.LocalAccounts Module

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

Syntaxe

Default (Par défaut) 

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

Description

L’applet de commande New-LocalGroup crée un groupe de sécurité local dans le Gestionnaire de comptes 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 invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Description

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Name

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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é des objets LocalUser, LocalGroupet LocalPrincipal qui décrit 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.