Share via

Add-LocalGroupMember

  • Referentie
Module:
Microsoft.PowerShell.LocalAccounts

Hiermee voegt u leden toe aan een lokale groep.

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

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 Beheer istrators op een lokale computer hebben machtigingen voor volledig beheer op die computer. Beperk het aantal gebruikers in de groep Beheer istrators.

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 Beheer istrators

Met deze opdracht worden verschillende leden toegevoegd aan de lokale groep Beheer istrators. 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
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Group

Hiermee geeft u de beveiligingsgroep waaraan deze cmdlet leden toevoegt.

Type:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.