Add-EntraDirectoryRoleMember

Modulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Aggiunge un membro a un ruolo della directory.

Sintassi

Default (Impostazione predefinita) 

Add-EntraDirectoryRoleMember

    -DirectoryRoleId <String>
    -MemberId <String>
    [<CommonParameters>]

Descrizione

Il Add-EntraDirectoryRoleMember cmdlet aggiunge un membro a un ruolo Microsoft Entra ID.

Negli scenari delegati, l'utente connesso deve avere un ruolo di Microsoft Entra supportato o un ruolo personalizzato con le autorizzazioni necessarie. I ruoli minimi necessari per questa operazione sono:

  • Amministratore di ruolo privilegiato

Esempio

Esempio 1: Aggiungere un membro a un ruolo Microsoft Entra ID

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$directoryRole = Get-EntraDirectoryRole -Filter "DisplayName eq 'Helpdesk Administrator'"
$user = Get-EntraUser -UserId 'SawyerM@Contoso.com'
Add-EntraDirectoryRoleMember -DirectoryRoleId $directoryRole.Id -MemberId $user.Id

In questo esempio viene aggiunto un membro a un ruolo della directory.

  • DirectoryRoleId parametro specifica l'ID del ruolo della directory a cui viene aggiunto il membro. Usare il comando Get-EntraDirectoryRole per recuperare i dettagli del ruolo della directory.
  • MemberIdparametro specifica l'ID dell'oggetto Microsoft Entra ID da assegnare come proprietario/manager/membro.

Parametri

-DirectoryRoleId

Specifica l'ID di un ruolo della directory in Microsoft Entra ID.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ObjectId

Set di parametri

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

-MemberId

Specifica l'ID dell'oggetto Microsoft Entra ID da assegnare come proprietario/manager/membro.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:RefObjectId

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
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.