Remove-LocalGroupMember

Tar bort medlemmar från en lokal grupp.

Syntax

Group

Remove-LocalGroupMember
    [-Group] <LocalGroup>
    [-Member] <LocalPrincipal[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default

Remove-LocalGroupMember
    [-Member] <LocalPrincipal[]>
    [-Name] <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SecurityIdentifier

Remove-LocalGroupMember
    [-Member] <LocalPrincipal[]>
    [-SID] <SecurityIdentifier>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

Anmärkning

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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Group

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

Parameteregenskaper

Typ:Microsoft.PowerShell.Commands.LocalGroup
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Group
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

Microsoft.PowerShell.Commands.LocalPrincipal[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Default
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SID

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

Parameteregenskaper

Typ:SecurityIdentifier
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SecurityIdentifier
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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 på LocalUser, LocalGroupoch 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.