Compartilhar via

Get-LocalGroup

Módulo:
Microsoft.PowerShell.LocalAccounts Module

Obtém os grupos de segurança locais.

Sintaxe

Default (Default) 

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

SecurityIdentifier 

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

Description

O cmdlet Get-LocalGroup 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.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Default
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SID

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

Propriedades do parâmetro

Tipo:

SecurityIdentifier[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SecurityIdentifier
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Você pode encaminhar uma cadeia de caracteres para este cmdlet.

SecurityIdentifier

Você pode canalizar um SID para este cmdlet.

Saídas

System.Management.Automation.SecurityAccountsManager.LocalGroup

Esse 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, LocalGroupe LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:

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

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