Condividi tramite

Remove-LocalGroupMember

  • Riferimento
Modulo:
Microsoft.PowerShell.LocalAccounts

Rimuove i membri da un gruppo locale.

Sintassi

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

Descrizione

Il Remove-LocalGroupMember cmdlet rimuove utenti o gruppi da un gruppo locale.

Nota

Il modulo Microsoft.PowerShell.LocalAccounts non è disponibile in PowerShell a 32 bit in un sistema a 64 bit.

Esempio

Esempio 1: Rimuovere membri dal gruppo Administrators

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

Questo comando rimuove diversi membri dal gruppo Administrators locale. I membri rimossi da questo cmdlet includono un account utente locale, un account Microsoft, un account Microsoft Entra e un gruppo di dominio. In questo esempio viene usato un valore segnaposto per il nome utente di un account in Outlook.com.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Group

Specifica il gruppo di sicurezza da cui questo cmdlet rimuove i membri.

Tipo:Microsoft.PowerShell.Commands.LocalGroup
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Member

Specifica una matrice di utenti o gruppi che questo cmdlet rimuove da un gruppo di sicurezza. È possibile specificare utenti o gruppi per nome, ID di sicurezza (SID) o oggetti LocalPrincipal . Specificare stringhe SID in S-R-I-S-S . . . (formato).

Tipo:Microsoft.PowerShell.Commands.LocalPrincipal[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome del gruppo di sicurezza da cui questo cmdlet rimuove i membri.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SID

Specifica l'ID di sicurezza del gruppo di sicurezza da cui questo cmdlet rimuove i membri.

Tipo:SecurityIdentifier
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

System.Management.Automation.SecurityAccountsManager.LocalPrincipal

È possibile inviare tramite pipe un'entità locale a questo cmdlet.

String

È possibile inviare tramite pipe una stringa a questo cmdlet.

SecurityIdentifier

È possibile inviare tramite pipe un SID a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

Windows PowerShell include gli alias seguenti per Remove-LocalGroupMember:

  • rlgm

La proprietà PrincipalSource è una proprietà sugli oggetti LocalUser, LocalGroup e LocalPrincipal che descrivono l'origine dell'oggetto. Le possibili origini sono le seguenti:

  • Locale
  • Active Directory
  • Gruppo di Microsoft Entra
  • Account Microsoft

PrincipalSource è supportato solo da Windows 10, Windows Server 2016 e versioni successive del sistema operativo Windows. Per le versioni precedenti, la proprietà è vuota.