Delen via

Remove-LocalGroup

  • Referentie
Module:
Microsoft.PowerShell.LocalAccounts

Hiermee verwijdert u lokale beveiligingsgroepen.

Syntaxis

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

Description

Met de Remove-LocalGroup cmdlet worden lokale beveiligingsgroepen verwijderd. Met deze cmdlet wordt alleen een lokale groep verwijderd. De gebruikersaccounts, computeraccounts of groepsaccounts die bij die groep horen, worden niet verwijderd. U kunt een verwijderde groep niet herstellen.

Als u een groep verwijdert en vervolgens een andere groep met dezelfde groepsnaam maakt, moet u nieuwe machtigingen instellen voor de nieuwe groep. De nieuwe groep neemt niet de machtigingen over die aan de groep zijn toegewezen.

Notitie

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

Voorbeelden

Voorbeeld 1: Een beveiligingsgroep verwijderen

Remove-LocalGroup -Name "SecurityGroup04"

Met deze opdracht wordt de groep met de naam SecurityGroup04 verwijderd.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u een matrix van beveiligingsgroepen op die door deze cmdlet worden verwijderd. Gebruik de Get-LocalGroup cmdlet om groepen te verkrijgen.

Type:Microsoft.PowerShell.Commands.LocalGroup[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u een matrix van namen op van de beveiligingsgroepen die door deze cmdlet worden verwijderd.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SID

Hiermee geeft u een matrix van beveiligings-id's (SID's) van beveiligingsgroepen op die door deze cmdlet worden verwijderd.

Type:SecurityIdentifier[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

System.Management.Automation.SecurityAccountsManager.LocalGroup

U kunt een beveiligingsgroep 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 Remove-LocalGroup:

  • rlg

Met deze cmdlet kunnen de volgende standaardgroepen niet worden verwijderd:

  • Beheerders
  • Back-Operators
  • Cryptografische Operators
  • Gedistribueerde COM-gebruikers
  • Lezers van gebeurtenislogboeken
  • Gasten
  • Hyper-V-beheerders
  • IIS_IUSRS
  • Network Configuration Operators
  • Gebruikers van prestatielogboeken
  • Prestatiemetergebruikers
  • Hoofdgebruikers
  • Extern bureaublad-gebruikers
  • Extern beheer van gebruikers
  • Replicatie
  • Gebruikers
  • WinRMRemoteWMIUsers__

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.