Remove-LocalGroup
Odstraní místní skupiny zabezpečení.
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>]
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 cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Určuje pole skupin zabezpečení, které tato rutina odstraní. K získání skupin použijte rutinu Get-LocalGroup.
Vlastnosti parametru
| Typ: | Microsoft.PowerShell.Commands.LocalGroup[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InputObject
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje pole názvů skupin zabezpečení, které tato rutina odstraní.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Default
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-SID
Určuje pole ID zabezpečení (SID) skupin zabezpečení, které tato rutina odstraní.
Vlastnosti parametru
| Typ: | |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
SecurityIdentifier
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
System.Management.Automation.SecurityAccountsManager.LocalGroup
Do této rutiny můžete převést skupinu zabezpečení.
String
Do tohoto příkazletu můžete přesměrovat řetězec.
SecurityIdentifier
Identifikátor SID můžete do této rutiny převést.
Výstupy
None
Tento cmdlet 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
- Operátory zálohování
- Kryptografické operátory
- Distribuovaní uživatelé modelu COM
- Čtenáři protokolu událostí
- Hosté
- správci Hyper-V
- IIS_IUSRS
- Operátory konfigurace sítě
- Uživatelé protokolu výkonu
- Uživatelé monitoru výkonu
- Zkušenější uživatelé
- Uživatelé vzdálené plochy
- Uživatelé vzdálené správy
- Replikátor
- Uživatelé
- WinRMRemoteWMIUsers__
Vlastnost PrincipalSource je vlastnost objektů LocalUser, LocalGroupa LocalPrincipal, která popisuje zdroj objektu. Možné zdroje jsou následující:
- Místní
- služba 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á.
