Remove-LocalGroupMember

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

Usuwa członków z grupy lokalnej.

Składnia

Remove-LocalGroupMember
      [-Group] <LocalGroup>
      [-Member] <LocalPrincipal[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroupMember
      [-Member] <LocalPrincipal[]>
      [-Name] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroupMember
      [-Member] <LocalPrincipal[]>
      [-SID] <SecurityIdentifier>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie Remove-LocalGroupMember cmdlet usuwa użytkowników lub grupy z grupy lokalnej.

Uwaga

Moduł Microsoft.PowerShell.LocalAccounts nie jest dostępny w 32-bitowym programie PowerShell w systemie 64-bitowym.

Przykłady

Przykład 1. Usuwanie elementów członkowskich z grupy Administracja istrators

$members = "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"
Remove-LocalGroupMember -Group "Administrators" -Member $members

To polecenie usuwa kilka elementów członkowskich z lokalnej grupy Administracja istratorów. Członkowie, których to polecenie cmdlet usuwa, obejmują konto użytkownika lokalnego, konto Microsoft, konto Microsoft Entra i grupę domen. W tym przykładzie użyto wartości zastępczej dla nazwy użytkownika konta w Outlook.com.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Group

Określa grupę zabezpieczeń, z której to polecenie cmdlet usuwa członków.

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

-Member

Określa tablicę użytkowników lub grup, które to polecenie cmdlet usuwa z grupy zabezpieczeń. Można określić użytkowników lub grupy według nazwy, identyfikatora zabezpieczeń (SID) lub obiektów LocalPrincipal . Określ ciągi SID w S-R-I-S-S. . . Format eksportu x.

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

-Name

Określa nazwę grupy zabezpieczeń, z której to polecenie cmdlet usuwa członków.

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

-SID

Określa identyfikator zabezpieczeń grupy zabezpieczeń, z której to polecenie cmdlet usuwa członków.

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

-WhatIf

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

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

Dane wejściowe

System.Management.Automation.SecurityAccountsManager.LocalPrincipal

Możesz przekazać podmiot zabezpieczeń lokalnych 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-LocalGroupMember:

  • rlgm

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.