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

Windows Update Deployment AdministratorMicrosoft Entra built-in role

Can create and manage all aspects of Windows Update deployments through the Windows Update for Business deployment service.

Role ID32696413-001a-46ae-978c-ce0f6b3620d2
PrivilegedNo
Permissions1

What it can do

PermissionWhat it allows
microsoft.windows.updatesDeployments/allEntities/allProperties/allTasksRead and configure all aspects of Windows Update Service

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 Windows Update Deployment Administrator for <reason>"
    RoleDefinitionId = "32696413-001a-46ae-978c-ce0f6b3620d2"
    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 '32696413-001a-46ae-978c-ce0f6b3620d2'" -ExpandProperty Principal |
    ForEach-Object { $_.Principal.AdditionalProperties.displayName }

Related roles

Find the smallest role for a task →