Remove-LocalGroup
Usuwa lokalne grupy zabezpieczeń.
Składnia
InputObject
Remove-LocalGroup
[-InputObject] <LocalGroup[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Remove-LocalGroup
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Remove-LocalGroup
[-SID] <SecurityIdentifier[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Remove-LocalGroup usuwa lokalne grupy zabezpieczeń. To polecenie cmdlet usuwa tylko grupę lokalną. Nie usuwa kont użytkowników, kont komputerów ani kont grup należących do tej grupy. Nie można odzyskać usuniętej grupy.
Jeśli usuniesz grupę, a następnie utworzysz inną grupę, która ma taką samą nazwę grupy, musisz ustawić nowe uprawnienia dla nowej grupy. Nowa grupa nie dziedziczy uprawnień przypisanych do grupy.
Uwaga / Notatka
Moduł Microsoft.PowerShell.LocalAccounts nie jest dostępny w 32-bitowym programie PowerShell w systemie 64-bitowym.
Przykłady
Przykład 1. Usuwanie grupy zabezpieczeń
Remove-LocalGroup -Name "SecurityGroup04"
To polecenie usuwa grupę o nazwie SecurityGroup04.
Parametry
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-InputObject
Określa tablicę grup zabezpieczeń usuwanych przez to polecenie cmdlet. Aby uzyskać grupy, użyj polecenia cmdlet Get-LocalGroup.
Właściwości parametru
| Typ: | Microsoft.PowerShell.Commands.LocalGroup[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
InputObject
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Name
Określa tablicę nazw grup zabezpieczeń, które usuwa to polecenie cmdlet.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Default
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-SID
Określa tablicę identyfikatorów zabezpieczeń (SID) grup zabezpieczeń usuwanych przez to polecenie cmdlet.
Właściwości parametru
| Typ: | |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
SecurityIdentifier
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
System.Management.Automation.SecurityAccountsManager.LocalGroup
Możesz przekazać grupę zabezpieczeń do tego polecenia cmdlet.
String
Możesz przesłać ciąg do tego polecenia cmdlet.
SecurityIdentifier
Do tego polecenia cmdlet można przekazać identyfikator SID.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Uwagi
Program Windows PowerShell zawiera następujące aliasy dla Remove-LocalGroup:
rlg
To polecenie cmdlet nie może usunąć następujących grup domyślnych:
- Administrators
- Operatory kopii zapasowych
- Operatory kryptograficzne
- Użytkownicy rozproszonego modelu COM
- Czytelnicy dziennika zdarzeń
- Goście
- Administratorzy Hyper-V
- IIS_IUSRS
- Operatorzy konfiguracji sieci
- Użytkownicy dziennika wydajności
- Użytkownicy monitora wydajności
- Zaawansowani użytkownicy
- Użytkownicy pulpitu zdalnego
- Użytkownicy zarządzania zdalnego
- Replikator
- Użytkownicy
- WinRMRemoteWMIUsers__
Właściwość PrincipalSource jest właściwością obiektów LocalUser, LocalGroupi LocalPrincipal, która opisuje źródło obiektu. Możliwe źródła są następujące:
- Lokalny
- Active Directory
- Grupa Microsoft Entra
- Konto Microsoft
PrincipalSource jest obsługiwana tylko przez system Windows 10, Windows Server 2016 i nowsze wersje systemu operacyjnego Windows. W przypadku wcześniejszych wersji właściwość jest pusta.
