← cd ~/roles
// roles/entra
Teams Telephony AdministratorMicrosoft Entra built-in role
Manage voice and telephony features and troubleshoot communication issues within the Microsoft Teams service.
| Role ID | aa38014f-0993-46e9-9b45-30501a20909d |
|---|---|
| Privileged | No |
| Permissions | 10 |
What it can do
| Permission | What it allows |
|---|---|
microsoft.azure.serviceHealth/allEntities/allTasks | Read and configure Azure Service Health |
microsoft.azure.supportTickets/allEntities/allTasks | Create and manage Azure support tickets |
microsoft.directory/authorizationPolicy/standard/read | Read standard properties of authorization policy |
microsoft.office365.serviceHealth/allEntities/allTasks | Read and configure Service Health in the Microsoft 365 admin center |
microsoft.office365.skypeForBusiness/allEntities/allTasks | Manage all aspects of Skype for Business Online |
microsoft.office365.supportTickets/allEntities/allTasks | Create and manage Microsoft 365 service requests |
microsoft.office365.usageReports/allEntities/allProperties/read | Read Office 365 usage reports |
microsoft.office365.webPortal/allEntities/standard/read | Read basic properties on all resources in the Microsoft 365 admin center |
microsoft.teams/callQuality/allProperties/read | Read all data in the Call Quality Dashboard (CQD) |
microsoft.teams/voice/allProperties/allTasks | Manage voice including calling policies and phone number inventory and assignment |
Assign it
The role ID is the same in every tenant, so these work as they are. Make it eligible through PIM:
Connect-MgGraph -Scopes "RoleEligibilitySchedule.ReadWrite.Directory"
$user = Get-MgUser -UserId "jane.doe@contoso.com"
New-MgRoleManagementDirectoryRoleEligibilityScheduleRequest -BodyParameter @{
Action = "AdminAssign"
Justification = "Needs Teams Telephony Administrator for <reason>"
RoleDefinitionId = "aa38014f-0993-46e9-9b45-30501a20909d"
DirectoryScopeId = "/"
PrincipalId = $user.Id
ScheduleInfo = @{
StartDateTime = (Get-Date).ToUniversalTime().ToString("o")
Expiration = @{ Type = "afterDuration"; Duration = "P180D" }
}
}Who already has it?
Connect-MgGraph -Scopes "RoleManagement.Read.Directory"
Get-MgRoleManagementDirectoryRoleAssignment -Filter "roleDefinitionId eq 'aa38014f-0993-46e9-9b45-30501a20909d'" -ExpandProperty Principal |
ForEach-Object { $_.Principal.AdditionalProperties.displayName }Related roles
- Attribute Assignment Administrator · 10 permissions
- IoT Device Administrator · 10 permissions
- Compliance Data Administrator · 9 permissions
- Knowledge Manager · 11 permissions
- License Administrator · 9 permissions
- Teams Communications Administrator · 11 permissions
- Dragon Administrator · 8 permissions
- Dynamics 365 Business Central Administrator · 8 permissions