Partager via

Get-LocalGroup

Module:
Microsoft.PowerShell.LocalAccounts Module

Obtient les groupes de sécurité locaux.

Syntaxe

Default (Par défaut) 

Get-LocalGroup
    [[-Name] <String[]>]
    [<CommonParameters>]

SecurityIdentifier 

Get-LocalGroup
    [[-SID] <SecurityIdentifier[]>]
    [<CommonParameters>]

Description

L’applet de commande Get-LocalGroup obtient des groupes de sécurité locaux dans le Gestionnaire de compte de sécurité. Cette applet de commande obtient les groupes intégrés par défaut et les groupes de sécurité locaux que vous créez.

Remarque

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

Exemples

Exemple 1 : Obtenir le groupe Administrateurs

Get-LocalGroup -Name "Administrators"

Cette commande obtient le groupe Administrateurs local. La commande affiche les propriétés du groupe dans la console.

Paramètres

-Name

Spécifie un tableau de noms de groupes de sécurité que cette applet de commande obtient. Vous pouvez utiliser le caractère générique.

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

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

-SID

Spécifie un tableau d’ID de sécurité (SID) de groupes de sécurité que cette applet de commande obtient.

Propriétés du paramètre

Type:

SecurityIdentifier[]

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

Jeux de paramètres

SecurityIdentifier
Position:0
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
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.

SecurityIdentifier

Vous pouvez diriger un SID vers cette applet de commande.

Sorties

System.Management.Automation.SecurityAccountsManager.LocalGroup

Cette applet de commande retourne un groupe local.

Notes

Windows PowerShell inclut les alias suivants pour Get-LocalGroup:

  • glg

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
  • Groupe Microsoft Entra
  • Compte Microsoft

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.