← cd ~/roles
// roles/entra
Teams External Collaboration AdministratorMicrosoft Entra built-in role
Manage external collaboration policies and settings for Teams, including configuring external domains and controlling which groups and users can interact with the organization.
| Role ID | 2fe872fb-daa8-4afc-8f6c-53c4565cfef4 |
|---|---|
| Privileged | No |
| Permissions | 4 |
What it can do
| Permission | What it allows |
|---|---|
microsoft.azure.supportTickets/allEntities/allTasks | Create and manage Azure support tickets |
microsoft.directory/authorizationPolicy/standard/read | Read standard properties of authorization policy |
microsoft.office365.webPortal/allEntities/standard/read | Read basic properties on all resources in the Microsoft 365 admin center |
microsoft.teams/policies/externalAccessPolicy/allTasks | Create and manage policies that govern external access. |
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 External Collaboration Administrator for <reason>"
RoleDefinitionId = "2fe872fb-daa8-4afc-8f6c-53c4565cfef4"
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 '2fe872fb-daa8-4afc-8f6c-53c4565cfef4'" -ExpandProperty Principal |
ForEach-Object { $_.Principal.AdditionalProperties.displayName }Related roles
- Desktop Analytics Administrator · 4 permissions
- Entra Backup Reader · 4 permissions
- Kaizala Administrator · 4 permissions
- Attack Simulation Administrator · 3 permissions
- Edge Administrator · 3 permissions
- Insights Analyst · 3 permissions
- Message Center Privacy Reader · 3 permissions
- Microsoft 365 Migration Administrator · 3 permissions