Delegated access in Windows Virtual Desktop - Azure
How to delegate administrative capabilities on a Windows Virtual Desktop deployment, including examples.
Delegated access in Windows Virtual Desktop
Windows Virtual Desktop has a delegated access model that lets you define the amount of access a particular user is allowed to have by assigning them a role. A role assignment has three components: security principal, role definition, and scope. The Windows Virtual Desktop delegated access model is based on the Azure RBAC model. To learn more about specific role assignments and their components, see the Azure role-based access control overview.
Windows Virtual Desktop delegated access supports the following values for each element of the role assignment:
- Security principal
- Service principals
- Role definition
- Built-in roles
- Tenant groups
- Host pools
- App groups
Delegated access in Windows Virtual Desktop has several built-in role definitions you can assign to users and service principals.
- An RDS Owner can manage everything, including access to resources.
- An RDS Contributor can manage everything but access to resources.
- An RDS Reader can view everything but can't make any changes.
- An RDS Operator can view diagnostic activities.
PowerShell cmdlets for role assignments
You can run the following cmdlets to create, view, and remove role assignments:
- Get-RdsRoleAssignment displays a list of role assignments.
- New-RdsRoleAssignment creates a new role assignment.
- Remove-RdsRoleAssignment deletes role assignments.
You can modify the basic three cmdlets with the following parameters:
- AadTenantId: specifies the Azure Active Directory tenant ID from which the service principal is a member.
- AppGroupName: name of the Remote Desktop app group.
- Diagnostics: indicates the diagnostics scope. (Must be paired with either the Infrastructure or Tenant parameters.)
- HostPoolName: name of the Remote Desktop host pool.
- Infrastructure: indicates the infrastructure scope.
- RoleDefinitionName: name of the Remote Desktop Services role-based access control role assigned to the user, group, or app. (For example, Remote Desktop Services Owner, Remote Desktop Services Reader, and so on.)
- ServerPrincipleName: name of the Azure Active Directory application.
- SignInName: the user's email address or user principal name.
- TenantName: name of the Remote Desktop tenant.
For a more complete list of PowerShell cmdlets each role can use, see the PowerShell reference.
For guidelines for how to set up a Windows Virtual Desktop environment, see Windows Virtual Desktop environment.