Delen via

Add-LocalGroupMember

  • Referentie
Module:
Microsoft.PowerShell.LocalAccounts

Hiermee voegt u leden toe aan een lokale groep.

Syntaxis

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>]

Description

Met de Add-LocalGroupMember cmdlet worden gebruikers of groepen toegevoegd aan een lokale beveiligingsgroep. Alle rechten en machtigingen die aan een groep zijn toegewezen, worden toegewezen aan alle leden van die groep.

Leden van de groep Administrators op een lokale computer hebben machtigingen voor volledig beheer op die computer. Beperk het aantal gebruikers in de groep Administrators.

Als de computer lid is van een domein, kunt u gebruikersaccounts, computeraccounts en groepsaccounts uit dat domein en van vertrouwde domeinen toevoegen aan een lokale groep.

Notitie

Als de computer lid is van een domein en u probeert een lokale gebruiker toe te voegen met dezelfde naam als een lid van het domein, wordt het domeinlid toegevoegd.

Voorbeelden

Voorbeeld 1: Leden toevoegen aan de groep Administrators

Met deze opdracht worden verschillende leden toegevoegd aan de lokale groep Administrators. De nieuwe leden bevatten een lokaal gebruikersaccount, een Microsoft-account, een Microsoft Entra-account en een domeingroep. In dit voorbeeld wordt een tijdelijke aanduiding gebruikt voor de gebruikersnaam van een account op Outlook.com.

Add-LocalGroupMember -Group "Administrators" -Member "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Group

Hiermee geeft u de beveiligingsgroep waaraan deze cmdlet leden toevoegt.

Type:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Member

Hiermee geeft u een matrix op van gebruikers of groepen die met deze cmdlet worden toegevoegd aan een beveiligingsgroep. U kunt gebruikers of groepen opgeven op naam, beveiligings-id (SID) of LocalPrincipal-objecten .

Type:Microsoft.PowerShell.Commands.LocalPrincipal[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam op van de beveiligingsgroep waaraan deze cmdlet leden toevoegt.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SID

Hiermee geeft u de beveiligings-id op van de beveiligingsgroep waaraan met deze cmdlet leden worden toegevoegd.

Type:SecurityIdentifier
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

System.Management.Automation.SecurityAccountsManager.LocalGroup

U kunt een lokale principal doorsluisen naar deze cmdlet.

String

U kunt een tekenreeks doorsluisen naar deze cmdlet.

SecurityIdentifier

U kunt een SID doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Windows PowerShell bevat de volgende aliassen voor Add-LocalGroupMember:

  • algm

De module Microsoft.PowerShell.LocalAccounts is niet beschikbaar in 32-bits PowerShell op een 64-bits systeem.

De eigenschap PrincipalSource is een eigenschap voor LocalUser-, LocalGroup- en LocalPrincipal-objecten die de bron van het object beschrijven. De mogelijke bronnen zijn als volgt:

  • Lokaal
  • Active Directory
  • Microsoft Entra-groep
  • Microsoft-account

PrincipalSource wordt alleen ondersteund door Windows 10, Windows Server 2016 en latere versies van het Windows-besturingssysteem. Voor eerdere versies is de eigenschap leeg.