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

Tenant CreatorMicrosoft Entra built-in role

Create new Microsoft Entra or Azure AD B2C tenants.

Role ID112ca1a2-15ad-4102-995e-45b0bc479a6a
PrivilegedNo
Permissions1

What it can do

PermissionWhat it allows
microsoft.directory/tenantManagement/tenants/createCreate new tenants in Microsoft Entra ID

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 Tenant Creator for <reason>"
    RoleDefinitionId = "112ca1a2-15ad-4102-995e-45b0bc479a6a"
    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 '112ca1a2-15ad-4102-995e-45b0bc479a6a'" -ExpandProperty Principal |
    ForEach-Object { $_.Principal.AdditionalProperties.displayName }

Related roles

Find the smallest role for a task →

Sources