Condividi tramite

Add-LocalGroupMember

  • Riferimento
Modulo:
Microsoft.PowerShell.LocalAccounts

Aggiunge membri a un gruppo locale.

Sintassi

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

Descrizione

Il Add-LocalGroupMember cmdlet aggiunge utenti o gruppi a un gruppo di sicurezza locale. Tutti i diritti e le autorizzazioni assegnati a un gruppo vengono assegnati a tutti i membri del gruppo.

I membri del gruppo Administrators in un computer locale dispongono delle autorizzazioni controllo completo per tale computer. Limitare il numero di utenti nel gruppo Administrators.

Se il computer viene aggiunto a un dominio, è possibile aggiungere account utente, account computer e account di gruppo da tale dominio e da domini attendibili a un gruppo locale.

Nota

Se il computer viene aggiunto a un dominio e si tenta di aggiungere un utente locale con lo stesso nome di un membro del dominio, aggiunge il membro di dominio.

Esempio

Esempio 1: Aggiungere membri al gruppo Administrators

Questo comando aggiunge diversi membri al gruppo Administrators locale. I nuovi membri 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.

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

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 a cui questo cmdlet aggiunge 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 aggiunge a un gruppo di sicurezza. È possibile specificare utenti o gruppi per nome, ID di sicurezza (SID) o oggetti LocalPrincipal .

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 a cui questo cmdlet aggiunge 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 a cui questo cmdlet aggiunge 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.LocalGroup

È 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 Add-LocalGroupMember:

  • algm

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

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.