Delen via

Remove-LocalGroupMember

Module:
Microsoft.PowerShell.LocalAccounts Module

Hiermee verwijdert u leden uit een lokale groep.

Syntax

Group 

Remove-LocalGroupMember
    [-Group] <LocalGroup>
    [-Member] <LocalPrincipal[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default 

Remove-LocalGroupMember
    [-Member] <LocalPrincipal[]>
    [-Name] <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SecurityIdentifier 

Remove-LocalGroupMember
    [-Member] <LocalPrincipal[]>
    [-SID] <SecurityIdentifier>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Met de Remove-LocalGroupMember cmdlet worden gebruikers of groepen uit een lokale groep verwijderd.

Opmerking

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

Voorbeelden

Voorbeeld 1: Leden verwijderen uit de groep Administrators

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

Met deze opdracht worden verschillende leden uit de lokale groep Administrators verwijderd. De leden die deze cmdlet verwijdert, 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.

Parameters

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Group

Hiermee geeft u de beveiligingsgroep waaruit deze cmdlet leden verwijdert.

Parametereigenschappen

Type:Microsoft.PowerShell.Commands.LocalGroup
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Group
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Member

Hiermee geeft u een matrix op van gebruikers of groepen die met deze cmdlet worden verwijderd uit een beveiligingsgroep. U kunt gebruikers of groepen opgeven op naam, beveiligings-id (SID) of LocalPrincipal-objecten. Geef SID-tekenreeksen op in S-R-I-S-S. . . formatteren.

Parametereigenschappen

Type:

Microsoft.PowerShell.Commands.LocalPrincipal[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

Hiermee geeft u de naam op van de beveiligingsgroep waaruit deze cmdlet leden verwijdert.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Default
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SID

Hiermee geeft u de beveiligings-id op van de beveiligingsgroep waaruit deze cmdlet leden verwijdert.

Parametereigenschappen

Type:SecurityIdentifier
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SecurityIdentifier
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

System.Management.Automation.SecurityAccountsManager.LocalPrincipal

U kunt een lokale principal doorsluisen naar deze cmdlet.

String

U kunt een tekenreeks doorsluizen 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 Remove-LocalGroupMember:

  • rlgm

De eigenschap PrincipalSource is een eigenschap in LocalUser, LocalGroupen 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.