Edit

Share via

Add-EntraDirectoryRoleMember

  • Reference
Module:
Microsoft.Graph.Entra

Adds a member to a directory role.

Syntax

Add-EntraDirectoryRoleMember
    -ObjectId <String>
    -RefObjectId <String> 
   [<CommonParameters>]

Description

The Add-EntraDirectoryRoleMember cmdlet adds a member to a Microsoft Entra ID role.

Examples

Example 1: Add a member to a Microsoft Entra ID role

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$params = @{
    ObjectId = '019ea7a2-1613-47c9-81cb-20ba35b1ae48'
    RefObjectId = 'bbbbbbbb-1111-2222-3333-cccccccccccc'
}
Add-EntraDirectoryRoleMember @params

This example adds a member to a directory role.

  • ObjectId parameter specifies the ID of the directory role to which the member is added. Use the Get-EntraDirectoryRole command to retrieve the details of the directory role.
  • RefObjectId parameter specifies the ID of Microsoft Entra ID object to assign as owner/manager/member.

Parameters

-ObjectId

Specifies the ID of a directory role in Microsoft Entra ID.

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RefObjectId

Specifies the ID of the Microsoft Entra ID object to assign as owner/manager/member.

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False