Remove-LocalGroup

  • Reference
Modul:
Microsoft.PowerShell.LocalAccounts

Odstraní místní skupiny zabezpečení.

Syntax

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

Description

Rutina Remove-LocalGroup odstraní místní skupiny zabezpečení. Tato rutina odstraní pouze místní skupinu. Neodstraní uživatelské účty, účty počítačů ani skupinové účty, které patří do této skupiny. Odstraněnou skupinu nelze obnovit.

Pokud odstraníte skupinu a pak vytvoříte další skupinu se stejným názvem skupiny, musíte pro novou skupinu nastavit nová oprávnění. Nová skupina nedědí oprávnění přiřazená ke skupině.

Poznámka:

Modul Microsoft.PowerShell.LocalAccounts není k dispozici v 32bitovém PowerShellu v 64bitovém systému.

Příklady

Příklad 1: Odstranění skupiny zabezpečení

Remove-LocalGroup -Name "SecurityGroup04"

Tento příkaz odstraní skupinu s názvem SecurityGroup04.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Určuje pole skupin zabezpečení, které tato rutina odstraní. K získání skupin použijte rutinu Get-LocalGroup .

Type:Microsoft.PowerShell.Commands.LocalGroup[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Určuje pole názvů skupin zabezpečení, které tato rutina odstraní.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SID

Určuje pole ID zabezpečení (SID) skupin zabezpečení, které tato rutina odstraní.

Type:SecurityIdentifier[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

System.Management.Automation.SecurityAccountsManager.LocalGroup

Do této rutiny můžete převést skupinu zabezpečení.

String

Do této rutiny můžete zamísit řetězec.

SecurityIdentifier

Identifikátor SID můžete do této rutiny převést.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Windows PowerShell obsahuje následující aliasy pro Remove-LocalGroup:

  • rlg

Tato rutina nemůže odstranit následující výchozí skupiny:

  • Správci
  • Backup Operators
  • Cryptographic Operators
  • Distribuovaní uživatelé modelu COM
  • Čtenáři protokolu událostí
  • Hosté
  • Hyper-V Administrators
  • IIS_IUSRS
  • Network Configuration Operators
  • Uživatelé protokolu výkonu
  • uživatelé Sledování výkonu
  • Power Users
  • Remote Desktop Users
  • Uživatelé vzdálené správy
  • Replicator
  • Uživatelé
  • WinRMRemoteWMIUsers__

PrincipalSource vlastnost je vlastnost localUser, LocalGroup a LocalPrincipal objekty, které popisují zdroj objektu. Možné zdroje jsou následující:

  • Místní
  • Active Directory
  • Skupina Microsoft Entra
  • Účet Microsoft

PrincipalSource podporuje jenom Windows 10, Windows Server 2016 a novější verze operačního systému Windows. U starších verzí je tato vlastnost prázdná.