Udostępnij przez

Get-LocalGroup

Moduł:
Microsoft.PowerShell.LocalAccounts Module

Pobiera lokalne grupy zabezpieczeń.

Składnia

Default (domyślnie) 

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

SecurityIdentifier 

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

Opis

Polecenie cmdlet Get-LocalGroup pobiera lokalne grupy zabezpieczeń w Menedżerze kont zabezpieczeń. To polecenie cmdlet pobiera domyślne grupy wbudowane i lokalne utworzone grupy zabezpieczeń.

Uwaga / Notatka

Moduł Microsoft.PowerShell.LocalAccounts nie jest dostępny w 32-bitowym programie PowerShell w systemie 64-bitowym.

Przykłady

Przykład 1. Pobieranie grupy Administratorzy

Get-LocalGroup -Name "Administrators"

To polecenie pobiera lokalną grupę Administratorzy. Polecenie wyświetla właściwości grupy w konsoli programu .

Parametry

-Name

Określa tablicę nazw grup zabezpieczeń pobieranych przez to polecenie cmdlet. Możesz użyć symbolu wieloznacznych.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Default
Position:0
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-SID

Określa tablicę identyfikatorów zabezpieczeń (SID) grup zabezpieczeń pobieranych przez to polecenie cmdlet.

Właściwości parametru

Typ:

SecurityIdentifier[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SecurityIdentifier
Position:0
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

Możesz przesłać ciąg do tego polecenia cmdlet.

SecurityIdentifier

Do tego polecenia cmdlet można przekazać identyfikator SID.

Dane wyjściowe

System.Management.Automation.SecurityAccountsManager.LocalGroup

To polecenie cmdlet zwraca grupę lokalną.

Uwagi

Program Windows PowerShell zawiera następujące aliasy dla Get-LocalGroup:

  • glg

Właściwość PrincipalSource jest właściwością obiektów LocalUser, LocalGroupi LocalPrincipal, która opisuje źródło obiektu. Możliwe źródła są następujące:

  • Lokalny
  • Active Directory
  • Grupa Microsoft Entra
  • Konto Microsoft

PrincipalSource jest obsługiwana tylko przez system Windows 10, Windows Server 2016 i nowsze wersje systemu operacyjnego Windows. W przypadku wcześniejszych wersji właściwość jest pusta.