Freigeben über

Add-LocalGroupMember

  • Referenz
Modul:
Microsoft.PowerShell.LocalAccounts

Fügt Einer lokalen Gruppe Mitglieder hinzu.

Syntax

Add-LocalGroupMember
   [-Group] <LocalGroup>
   [-Member] <LocalPrincipal[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-LocalGroupMember
   [-Member] <LocalPrincipal[]>
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-LocalGroupMember
   [-Member] <LocalPrincipal[]>
   [-SID] <SecurityIdentifier>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Add-LocalGroupMember Cmdlet 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

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Group

Gibt die Sicherheitsgruppe an, der dieses Cmdlet Mitglieder hinzufügt.

Typ:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Microsoft.PowerShell.Commands.LocalPrincipal[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der Sicherheitsgruppe an, der dieses Cmdlet Mitglieder hinzufügt.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SID

Gibt die Sicherheits-ID der Sicherheitsgruppe an, der dieses Cmdlet Mitglieder hinzufügt.

Typ:SecurityIdentifier
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

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 PrincipalSource-Eigenschaft ist eine Eigenschaft für LocalUser-, LocalGroup- und LocalPrincipal-Objekte , die die Quelle des Objekts beschreiben. 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.