Add-LocalGroupMember
Dodaje członków do grupy lokalnej.
Składnia
Group
Add-LocalGroupMember
[-Group] <LocalGroup>
[-Member] <LocalPrincipal[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Add-LocalGroupMember
[-Member] <LocalPrincipal[]>
[-Name] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Add-LocalGroupMember
[-Member] <LocalPrincipal[]>
[-SID] <SecurityIdentifier>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Add-LocalGroupMember dodaje użytkowników lub grupy do lokalnej grupy zabezpieczeń. Wszystkie prawa i uprawnienia przypisane do grupy są przypisane do wszystkich członków tej grupy.
Członkowie grupy Administratorzy na komputerze lokalnym mają uprawnienia Pełna kontrola na tym komputerze. Ogranicz liczbę użytkowników w grupie Administratorzy.
Jeśli komputer jest przyłączony do domeny, możesz dodać konta użytkowników, konta komputerów i konta grup z tej domeny i z zaufanych domen do grupy lokalnej.
Uwaga / Notatka
Jeśli komputer jest przyłączony do domeny i próbujesz dodać użytkownika lokalnego, który ma taką samą nazwę jak członek domeny, dodaje element członkowski domeny.
Przykłady
Przykład 1. Dodawanie członków do grupy Administratorzy
To polecenie dodaje kilku członków do lokalnej grupy Administratorzy. Nowi członkowie obejmują konto użytkownika lokalnego, konto Microsoft, konto Microsoft Entra i grupę domen. W tym przykładzie użyto wartości zastępczej dla nazwy użytkownika konta w Outlook.com.
Add-LocalGroupMember -Group "Administrators" -Member "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"
Parametry
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Group
Określa grupę zabezpieczeń, do której to polecenie cmdlet dodaje członków.
Właściwości parametru
| Typ: | Microsoft.PowerShell.Commands.LocalGroup |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Group
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Member
Określa tablicę użytkowników lub grup, które to polecenie cmdlet dodaje do grupy zabezpieczeń. Można określić użytkowników lub grupy według nazwy, identyfikatora zabezpieczeń (SID) lub obiektów LocalPrincipal.
Właściwości parametru
| Typ: | Microsoft.PowerShell.Commands.LocalPrincipal[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 1 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Name
Określa nazwę grupy zabezpieczeń, do której to polecenie cmdlet dodaje członków.
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: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-SID
Określa identyfikator zabezpieczeń grupy zabezpieczeń, do której to polecenie cmdlet dodaje członków.
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: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| 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
System.Management.Automation.SecurityAccountsManager.LocalGroup
Możesz przekazać podmiot zabezpieczeń lokalnych do tego polecenia cmdlet.
String
Możesz przesłać ciąg do tego polecenia cmdlet.
SecurityIdentifier
Do tego polecenia cmdlet można przekazać identyfikator SID.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Uwagi
Program Windows PowerShell zawiera następujące aliasy dla Add-LocalGroupMember:
algm
Moduł Microsoft.PowerShell.LocalAccounts nie jest dostępny w 32-bitowym programie PowerShell w systemie 64-bitowym.
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.
