Add-LocalGroupMember
Fügt Einer lokalen Gruppe Mitglieder hinzu.
Syntax
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>]
Beschreibung
Das Cmdlet Add-LocalGroupMember fügt Einer lokalen Sicherheitsgruppe Benutzer oder Gruppen hinzu. Alle Berechtigungen und Berechtigungen, die einer Gruppe zugewiesen sind, werden allen Mitgliedern dieser Gruppe zugewiesen.
Mitglieder der Gruppe "Administratoren" auf einem lokalen Computer verfügen über Vollzugriffsberechtigungen auf diesem Computer. Beschränken Sie die Anzahl der Benutzer in der Gruppe "Administratoren".
Wenn der Computer einer Domäne beigetreten ist, können Sie Benutzerkonten, Computerkonten und Gruppenkonten aus dieser Domäne und von vertrauenswürdigen Domänen zu einer lokalen Gruppe hinzufügen.
Hinweis
Wenn der Computer einer Domäne beigetreten ist und Sie versuchen, einen lokalen Benutzer hinzuzufügen, der denselben Namen wie ein Mitglied der Domäne aufweist, der das Domänenmitglied hinzufügt.
Beispiele
Beispiel 1: Hinzufügen von Mitgliedern zur Gruppe "Administratoren"
Mit diesem Befehl werden der lokalen Gruppe "Administratoren" mehrere Mitglieder hinzugefügt. Die neuen Mitglieder umfassen ein lokales Benutzerkonto, ein Microsoft-Konto, ein Microsoft Entra-Konto und eine Domänengruppe. In diesem Beispiel wird ein Platzhalterwert für den Benutzernamen eines Kontos bei Outlook.com verwendet.
Add-LocalGroupMember -Group "Administrators" -Member "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"
Parameter
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Group
Gibt die Sicherheitsgruppe an, der dieses Cmdlet Mitglieder hinzufügt.
Parametereigenschaften
| Typ: | Microsoft.PowerShell.Commands.LocalGroup |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Group
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Member
Gibt ein Array von Benutzern oder Gruppen an, die dieses Cmdlet einer Sicherheitsgruppe hinzufügt. Sie können Benutzer oder Gruppen nach Name, Sicherheits-ID (SID) oder LocalPrincipal--Objekten angeben.
Parametereigenschaften
| Typ: | Microsoft.PowerShell.Commands.LocalPrincipal[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den Namen der Sicherheitsgruppe an, der dieses Cmdlet Mitglieder hinzufügt.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Default
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SID
Gibt die Sicherheits-ID der Sicherheitsgruppe an, der dieses Cmdlet Mitglieder hinzufügt.
Parametereigenschaften
| Typ: | SecurityIdentifier |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
SecurityIdentifier
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
System.Management.Automation.SecurityAccountsManager.LocalGroup
Sie können einen lokalen Prinzipal an dieses Cmdlet weiterleiten.
String
Sie können eine Zeichenfolge an dieses Cmdlet weiterleiten.
SecurityIdentifier
Sie können eine SID an dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
Windows PowerShell enthält die folgenden Aliase für Add-LocalGroupMember:
algm
Das Microsoft.PowerShell.LocalAccounts-Modul ist in 32-Bit-PowerShell auf einem 64-Bit-System nicht verfügbar.
Die Eigenschaft PrincipalSource ist eine Eigenschaft für LocalUser, LocalGroupund LocalPrincipal Objekte, die die Quelle des Objekts beschreibt. Die möglichen Quellen sind wie folgt:
- Lokal
- Active Directory
- Microsoft Entra Gruppe
- Microsoft-Konto
PrincipalSource- wird nur von Windows 10, Windows Server 2016 und höheren Versionen des Windows-Betriebssystems unterstützt. Bei früheren Versionen ist die Eigenschaft leer.
