Condividi tramite


Add-LocalGroupMember

Aggiunge membri a un gruppo locale.

Sintassi

Group

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

Default

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

SecurityIdentifier

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

Descrizione

Il cmdlet Add-LocalGroupMember 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.

Annotazioni

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Group

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

Proprietà dei parametri

Tipo:Microsoft.PowerShell.Commands.LocalGroup
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Group
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Member

Specifica una matrice di utenti o gruppi che questo cmdlet aggiunge a un gruppo di sicurezza. È possibile specificare utenti o gruppi in base al nome, all'ID di sicurezza (SID) o oggetti LocalPrincipal.

Proprietà dei parametri

Tipo:

Microsoft.PowerShell.Commands.LocalPrincipal[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SID

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

Proprietà dei parametri

Tipo:SecurityIdentifier
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SecurityIdentifier
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

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 alcun 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à degli oggetti LocalUser, LocalGroupe LocalPrincipal, che descrive l'origine dell'oggetto. Le possibili origini sono le seguenti:

  • Locale
  • Active Directory
  • Il 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.