Remove-LocalGroup
Löscht lokale Sicherheitsgruppen.
Syntax
InputObject
Remove-LocalGroup
[-InputObject] <LocalGroup[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Remove-LocalGroup
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Remove-LocalGroup
[-SID] <SecurityIdentifier[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Remove-LocalGroup 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
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 |
-InputObject
Gibt ein Array von Sicherheitsgruppen an, die dieses Cmdlet löscht. Verwenden Sie zum Abrufen von Gruppen das Cmdlet Get-LocalGroup.
Parametereigenschaften
| Typ: | Microsoft.PowerShell.Commands.LocalGroup[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InputObject
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt ein Array von Namen der Sicherheitsgruppen an, die dieses Cmdlet löscht.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Default
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-SID
Gibt ein Array von Sicherheits-IDs (SIDs) von Sicherheitsgruppen an, die dieses Cmdlet löscht.
Parametereigenschaften
| Typ: | |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
SecurityIdentifier
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| 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.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
- Backup-Operatoren
- Kryptografieoperatoren
- Verteilte COM-Benutzer
- Ereignisprotokollleser
- Gäste
- Hyper-V-Administratoren
- IIS_IUSRS
- Netzwerkkonfigurationsoperatoren
- Leistungsprotokollbenutzer
- Systemmonitorbenutzer
- Hauptbenutzer
- Remotedesktopbenutzer
- Remoteverwaltungsbenutzer
- Replikator
- Benutzer
- WinRMRemoteWMIUsers__
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.
