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

Insights Business LeaderMicrosoft Entra built-in role

View and share dashboards and insights via the Microsoft Viva Insights app.

Role ID31e939ad-9672-4796-9c2e-873181342d2d
PrivilegedNo
Permissions2

What it can do

PermissionWhat it allows
microsoft.insights/programs/allProperties/updateDeploy and manage programs in Insights app
microsoft.insights/reports/allProperties/readView reports and dashboard in Insights app

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 Insights Business Leader for <reason>"
    RoleDefinitionId = "31e939ad-9672-4796-9c2e-873181342d2d"
    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 '31e939ad-9672-4796-9c2e-873181342d2d'" -ExpandProperty Principal |
    ForEach-Object { $_.Principal.AdditionalProperties.displayName }

Related roles

Find the smallest role for a task →