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

Teams Devices AdministratorMicrosoft Entra built-in role

Can perform management related tasks on Teams certified devices.

Role ID3d762c5a-1b6c-493f-843e-55a3b42923d4
PrivilegedNo
Permissions2

What it can do

PermissionWhat it allows
microsoft.office365.webPortal/allEntities/standard/readRead basic properties on all resources in the Microsoft 365 admin center
microsoft.teams/devices/standard/readManage all aspects of Teams-certified devices including configuration policies

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 Teams Devices Administrator for <reason>"
    RoleDefinitionId = "3d762c5a-1b6c-493f-843e-55a3b42923d4"
    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 '3d762c5a-1b6c-493f-843e-55a3b42923d4'" -ExpandProperty Principal |
    ForEach-Object { $_.Principal.AdditionalProperties.displayName }

Related roles

Find the smallest role for a task →