Udostępnij za pośrednictwem

Remove-LocalGroup

  • Odwołanie
Moduł:
Microsoft.PowerShell.LocalAccounts

Usuwa lokalne grupy zabezpieczeń.

Składnia

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

Opis

Polecenie Remove-LocalGroup cmdlet 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

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

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Określa tablicę grup zabezpieczeń usuwanych przez to polecenie cmdlet. Aby uzyskać grupy, użyj Get-LocalGroup polecenia cmdlet .

Typ:Microsoft.PowerShell.Commands.LocalGroup[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa tablicę nazw grup zabezpieczeń, które usuwa to polecenie cmdlet.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SID

Określa tablicę identyfikatorów zabezpieczeń (SID) grup zabezpieczeń usuwanych przez to polecenie cmdlet.

Typ:SecurityIdentifier[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

System.Management.Automation.SecurityAccountsManager.LocalGroup

Możesz przekazać grupę zabezpieczeń do tego polecenia cmdlet.

String

Możesz przekazać 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 programu Remove-LocalGroup:

  • rlg

To polecenie cmdlet nie może usunąć następujących grup domyślnych:

  • Administratorzy
  • Operatorzy kopii zapasowych
  • Operatorzy kryptograficzni
  • Użytkownicy DCOM
  • Czytelnicy dziennika zdarzeń
  • Goście
  • Administratorzy funkcji Hyper-V
  • IIS_IUSRS
  • Operatorzy konfiguracji sieci
  • Użytkownicy dziennika wydajności
  • użytkownicy monitor wydajności
  • Użytkownicy zaawansowani
  • Użytkownicy pulpitu zdalnego
  • Użytkownicy zarządzania zdalnego
  • Replikator
  • Użytkownicy
  • WinRMRemoteWMIUsers__

Właściwość PrincipalSource jest właściwością localuser, LocalGroup i LocalPrincipal obiektów opisujących źródło obiektu. Możliwe źródła są następujące:

  • Lokalny
  • Active Directory
  • Grupa Microsoft Entra
  • Microsoft Account

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