Get-LocalGroup

  • Referência
Módulo:
Microsoft.PowerShell.LocalAccounts

Obtém os grupos de segurança locais.

Syntax

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

Description

O Get-LocalGroup cmdlet obtém grupos de segurança locais no Gerenciador de Contas de Segurança. Esse cmdlet obtém grupos internos padrão e grupos de segurança locais que você cria.

Observação

O módulo Microsoft.PowerShell.LocalAccounts não está disponível no PowerShell de 32 bits em um sistema de 64 bits.

Exemplos

Exemplo 1: Obter o grupo Administradores

Get-LocalGroup -Name "Administrators"

Esse comando obtém o grupo Administradores local. O comando exibe as propriedades do grupo no console.

Parâmetros

-Name

Especifica uma matriz de nomes de grupos de segurança que esse cmdlet obtém. Você pode usar o caractere curinga.

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

-SID

Especifica uma matriz de IDs de segurança (SIDs) de grupos de segurança que esse cmdlet obtém.

Type:SecurityIdentifier[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Você pode canalizar uma cadeia de caracteres para esse cmdlet.

SecurityIdentifier

Você pode canalizar um SID para esse cmdlet.

Saídas

System.Management.Automation.SecurityAccountsManager.LocalGroup

Este cmdlet retorna um grupo local.

Observações

O Windows PowerShell inclui os seguintes aliases para Get-LocalGroup:

  • glg

A propriedade PrincipalSource é uma propriedade nos objetos LocalUser, LocalGroup e LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:

  • Local
  • Active Directory
  • Grupo do Microsoft Entra
  • Conta Microsoft

PrincipalSource é suportado apenas pelo Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Para versões anteriores, a propriedade está em branco.