azureblog.co.uk
← cd ~/roles
// roles/entra

Directory Synchronization AccountsMicrosoft Entra built-in role

Only used by Microsoft Entra Connect service.

Role IDd29b2b05-8046-44ba-8758-1e26182fcf32
PrivilegedNo
Permissions1

What it can do

PermissionWhat it allows
microsoft.directory/onPremisesSynchronization/standard/readRead standard on-premises directory synchronization information

Assign it

The role ID is the same in every tenant, so these work as they are. Make it eligible through PIM:

powershell13 lines
Connect-MgGraph -Scopes "RoleEligibilitySchedule.ReadWrite.Directory"
$user = Get-MgUser -UserId "jane.doe@contoso.com"
New-MgRoleManagementDirectoryRoleEligibilityScheduleRequest -BodyParameter @{
    Action           = "AdminAssign"
    Justification    = "Needs Directory Synchronization Accounts for <reason>"
    RoleDefinitionId = "d29b2b05-8046-44ba-8758-1e26182fcf32"
    DirectoryScopeId = "/"
    PrincipalId      = $user.Id
    ScheduleInfo     = @{
        StartDateTime = (Get-Date).ToUniversalTime().ToString("o")
        Expiration    = @{ Type = "afterDuration"; Duration = "P180D" }
    }
}

Who already has it?

powershell3 lines
Connect-MgGraph -Scopes "RoleManagement.Read.Directory"
Get-MgRoleManagementDirectoryRoleAssignment -Filter "roleDefinitionId eq 'd29b2b05-8046-44ba-8758-1e26182fcf32'" -ExpandProperty Principal |
    ForEach-Object { $_.Principal.AdditionalProperties.displayName }

Related roles

Find the smallest role for a task →