Sdílet prostřednictvím

Remove-LocalGroup

  • Reference
Modul:
Microsoft.PowerShell.LocalAccounts

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

Syntaxe

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

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

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

Typ:Microsoft.PowerShell.Commands.LocalGroup[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

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

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SID

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

Typ:SecurityIdentifier[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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á.