Freigeben über

Remove-LocalGroup

  • Referenz
Modul:
Microsoft.PowerShell.LocalAccounts

Löscht lokale Sicherheitsgruppen.

Syntax

Remove-LocalGroup
      [-InputObject] <LocalGroup[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-Name] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-SID] <SecurityIdentifier[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Remove-LocalGroup Cmdlet löscht lokale Sicherheitsgruppen. Dieses Cmdlet löscht nur eine lokale Gruppe. Die Benutzerkonten, Computerkonten oder Gruppenkonten, die zu dieser Gruppe gehören, werden nicht gelöscht. Sie können eine gelöschte Gruppe nicht wiederherstellen.

Wenn Sie eine Gruppe löschen und dann eine andere Gruppe mit demselben Gruppennamen erstellen, müssen Sie neue Berechtigungen für die neue Gruppe festlegen. Die neue Gruppe erbt nicht die Berechtigungen, die der Gruppe zugewiesen wurden.

Hinweis

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

Beispiele

Beispiel 1: Löschen einer Sicherheitsgruppe

Remove-LocalGroup -Name "SecurityGroup04"

Mit diesem Befehl wird die Gruppe mit dem Namen "SecurityGroup04" gelöscht.

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

-InputObject

Gibt ein Array von Sicherheitsgruppen an, die dieses Cmdlet löscht. Verwenden Sie das Get-LocalGroup Cmdlet, um Gruppen abzurufen.

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

-Name

Gibt ein Array von Namen der Sicherheitsgruppen an, die dieses Cmdlet löscht.

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

-SID

Gibt ein Array von Sicherheits-IDs (SIDs) von Sicherheitsgruppen an, die dieses Cmdlet löscht.

Typ:SecurityIdentifier[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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 eine Sicherheitsgruppe 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-LocalGroup:

  • rlg

Dieses Cmdlet kann die folgenden Standardgruppen nicht löschen:

  • Administratoren
  • Sicherungsoperatoren
  • Kryptografie-Operatoren
  • Distributed COM-Benutzer
  • Event Log Readers
  • Guests
  • Hyper-V-Administratoren
  • IIS_IUSRS
  • Netzwerkkonfigurations-Operatoren
  • Leistungsprotokollbenutzer
  • Systemmonitorbenutzer
  • Hauptbenutzer
  • Remotedesktopbenutzer
  • Remoteverwaltungsbenutzer
  • Replicator
  • Benutzer
  • WinRMRemoteWMIUsers__

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.