Remove-LocalGroupMember

Tar bort medlemmar från en lokal grupp.

Syntax

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>]

Description

Cmdleten Remove-LocalGroupMember tar bort användare eller grupper från en lokal grupp.

Kommentar

Modulen Microsoft.PowerShell.LocalAccounts är inte tillgänglig i 32-bitars PowerShell i ett 64-bitarssystem.

Exempel

Exempel 1: Ta bort medlemmar från gruppen Administratörer

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

Det här kommandot tar bort flera medlemmar från den lokala gruppen Administratörer. De medlemmar som den här cmdleten tar bort innehåller ett lokalt användarkonto, ett Microsoft-konto, ett Microsoft Entra-konto och en domängrupp. I det här exemplet används ett platshållarvärde för användarnamnet för ett konto på Outlook.com.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Group

Anger den säkerhetsgrupp som den här cmdleten tar bort medlemmar från.

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

-Member

Anger en matris med användare eller grupper som den här cmdleten tar bort från en säkerhetsgrupp. Du kan ange användare eller grupper efter namn, säkerhets-ID (SID) eller LocalPrincipal-objekt . Ange SID-strängar i S-R-I-S-S . . . -format.

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

-Name

Anger namnet på säkerhetsgruppen som den här cmdleten tar bort medlemmar från.

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

-SID

Anger säkerhets-ID för säkerhetsgruppen som den här cmdleten tar bort medlemmar från.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

System.Management.Automation.SecurityAccountsManager.LocalPrincipal

Du kan skicka ett lokalt huvudnamn till den här cmdleten.

String

Du kan skicka en sträng till den här cmdleten.

SecurityIdentifier

Du kan skicka ett SID till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

Windows PowerShell innehåller följande alias för Remove-LocalGroupMember:

  • rlgm

Egenskapen PrincipalSource är en egenskap för LocalUser-, LocalGroup- och LocalPrincipal-objekt som beskriver objektets källa. Möjliga källor är följande:

  • Lokal
  • Active Directory
  • Microsoft Entra-grupp
  • Microsoft-konto

PrincipalSource stöds endast av Windows 10, Windows Server 2016 och senare versioner av Windows-operativsystemet. För tidigare versioner är egenskapen tom.