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

SharePoint Embedded AdministratorMicrosoft Entra built-in role

Manage all aspects of SharePoint Embedded containers.

Role ID1a7d78b6-429f-476b-b8eb-35fb715fffd4
PrivilegedNo
Permissions6

What it can do

PermissionWhat it allows
microsoft.office365.fileStorageContainers/allEntities/allProperties/allTasksManage all aspects of SharePoint Embedded containers
microsoft.office365.network/performance/allProperties/readRead all network performance properties in the Microsoft 365 admin center
microsoft.office365.serviceHealth/allEntities/allTasksRead and configure Service Health in the Microsoft 365 admin center
microsoft.office365.supportTickets/allEntities/allTasksCreate and manage Microsoft 365 service requests
microsoft.office365.usageReports/allEntities/allProperties/readRead Office 365 usage reports
microsoft.office365.webPortal/allEntities/standard/readRead basic properties on all resources in the Microsoft 365 admin center

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 SharePoint Embedded Administrator for <reason>"
    RoleDefinitionId = "1a7d78b6-429f-476b-b8eb-35fb715fffd4"
    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 '1a7d78b6-429f-476b-b8eb-35fb715fffd4'" -ExpandProperty Principal |
    ForEach-Object { $_.Principal.AdditionalProperties.displayName }

Related roles

Find the smallest role for a task →