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 Amministrazione istrators in un computer locale dispongono delle autorizzazioni controllo completo per tale computer. Limitare il numero di utenti nel gruppo Amministrazione istrators.

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 Amministrazione istrators

Questo comando aggiunge diversi membri al gruppo Amministrazione istrators 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.

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

-Group

Specifica il gruppo di sicurezza a cui questo cmdlet aggiunge membri.

Type:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 .

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

-Name

Specifica il nome del gruppo di sicurezza a cui questo cmdlet aggiunge membri.

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

-SID

Specifica l'ID di sicurezza del gruppo di sicurezza a cui questo cmdlet aggiunge membri.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 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.