Freigeben über

Remove-LocalGroupMember

Modul:
Microsoft.PowerShell.LocalAccounts Module

Entfernt Mitglieder aus einer lokalen Gruppe.

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

Beschreibung

Mit dem Cmdlet Remove-LocalGroupMember werden Benutzer oder Gruppen aus einer lokalen Gruppe entfernt.

Hinweis

Das Microsoft.PowerShell.LocalAccounts-Modul ist in 32-Bit-PowerShell auf einem 64-Bit-System nicht verfügbar.

Beispiele

Beispiel 1: Entfernen von Mitgliedern aus der Gruppe "Administratoren"

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

Mit diesem Befehl werden mehrere Mitglieder aus der lokalen Gruppe "Administratoren" entfernt. Die Mitglieder, die dieses Cmdlet entfernt, 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.

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, aus der dieses Cmdlet Mitglieder entfernt.

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 aus einer Sicherheitsgruppe entfernt. Sie können Benutzer oder Gruppen nach Name, Sicherheits-ID (SID) oder LocalPrincipal--Objekten angeben. Geben Sie SID-Zeichenfolgen in S-R-I-S-S an. . . Format.

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, aus der dieses Cmdlet Mitglieder entfernt.

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, aus der dieses Cmdlet Mitglieder entfernt.

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.LocalPrincipal

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 Remove-LocalGroupMember:

  • rlgm

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.