PowerShell de Azure Virtual Desktop (clásico)

Importante

Este contenido se aplica a Azure Virtual Desktop (clásico), que no admite objetos de Azure Resource Manager. Si está intentando administrar objetos de Azure Virtual Desktop para Azure Resource Manager, consulte este artículo.

Use este artículo para resolver los problemas y errores al usar PowerShell con Azure Virtual Desktop. Para más información sobre PowerShell para Servicios de Escritorio remoto, consulte PowerShell para Azure Virtual Desktop.

Envío de comentarios

Visite la comunidad técnica de Azure Virtual Desktop para analizar el servicio Azure Virtual Desktop con el equipo de producto y los miembros activos de la comunidad.

Comandos de PowerShell usados durante la configuración de Azure Virtual Desktop

En esta sección se enumeran los comandos de PowerShell que se usan normalmente durante la configuración de Azure Virtual Desktop, y proporciona maneras de resolver los problemas que pueden surgir al usarlos.

Error: Comando Add-RdsAppGroupUser: The specified UserPrincipalName is already assigned to a RemoteApp app group in the specified Host Pool (El UserPrincipalName especificado ya está asignado a un grupo de aplicaciones de RemoteApp en el grupo host especificado)

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName 'Desktop Application Group' -UserPrincipalName <UserName>

Causa: el nombre de usuario usado ya se ha asignado a un grupo de aplicaciones de un tipo diferente. Los usuarios no se pueden asignar tanto a un escritorio remoto como a un grupo de aplicaciones de RemoteApp en el mismo grupo de hosts de sesión.

Corrección: Si el usuario necesita tanto RemoteApp como un escritorio, cree grupos host diferentes o conceda al usuario acceso únicamente al escritorio remoto, lo que permitirá el uso de cualquier aplicación en la VM del host de sesión.

Error: Comando Add-RdsAppGroupUser: El UserPrincipalName especificado no existe en la instancia de Microsoft Entra ID asociada con el inquilino de Escritorio remoto

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName "Desktop Application Group" -UserPrincipalName <UserPrincipalName>

Causa: El usuario especificado por el valor de UserPrincipalName no se encuentra en la instancia de Microsoft Entra vinculada al inquilino de Azure Virtual Desktop.

Solución: Confirme los elementos de la lista siguiente.

• El usuario se sincroniza con Microsoft Entra ID.
• El usuario no está vinculado a comercio de negocio a consumidor (B2C) ni de negocio a negocio (B2B).
• El inquilino de Azure Virtual Desktop está vinculado a la instancia correcta de Microsoft Entra.

Error: Get-RdsDiagnosticActivities: User isn't authorized to query the management service (El usuario no está autorizado para consultar el servicio de administración)

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

Causa: Parámetro TenantName

Corrección: emita Get-RdsDiagnosticActivities con -TenantName <TenantName>.

Error: Get-RdsDiagnosticActivities: User isn't authorized to query the management service (El usuario no está autorizado para consultar el servicio de administración)

Get-RdsDiagnosticActivities -Deployment -username <username>

Causa: Uso del conmutador -Deployment.

Corrección: Solo los administradores de implementación pueden usar el conmutador Deployment. Estos administradores suelen ser miembros del equipo de Servicios de Escritorio remoto/Azure Virtual Desktop. Reemplace el conmutador -Deployment por -TenantName <TenantName>.

Error: New-RdsRoleAssignment: The user isn't authorized to query the management service (El usuario no está autorizado para consultar el servicio de administración)

Causa 1: La cuenta usada no tiene permisos de propietario de Servicios de Escritorio remoto en el inquilino.

Corrección 1: Un usuario con permisos de propietario de Servicios de Escritorio remoto debe ejecutar la asignación de roles.

Causa 2: La cuenta usada tiene permisos de propietario de Servicios de Escritorio remoto, pero no forma parte de la instancia de Microsoft Entra ID del inquilino o no tiene permisos para realizar consultas en la instancia de Microsoft Entra ID donde se encuentra el usuario.

Corrección 2: Un usuario con permisos de Active Directory debe ejecutar la asignación de roles.

Nota:

New-RdsRoleAssignment no puede conceder permisos a un usuario que no existe en Microsoft Entra ID.

Error: SessionHostPool no se pudo eliminar

Este error normalmente se produce cuando se ejecuta el siguiente comando para intentar quitar un host de sesión.

Remove-RdsHostPool -TenantName <TenantName> -Name <HostPoolName>

Causa: si ejecuta el comando antes de eliminar los objetos del nodo hoja del grupo de hosts, no funcionará.

Solución: ejecute el siguiente comando para eliminar el host de sesión.

Get-RdsSessionHost-TenantName <TenantName> -Hostpook <HostPoolName> | Remove-RdsSessionHost -Force

El uso del comando force le permitirá eliminar el host de sesión, aunque tenga usuarios asignados.

Pasos siguientes

• Para información general sobre la solución de problemas de Azure Virtual Desktop y las pistas de escalación, consulte Introducción a la solución de problemas, comentarios y soporte técnico.
• Para solucionar problemas durante la creación de un grupo de inquilinos y de hosts en un entorno de Azure Virtual Desktop, consulte Creación de los grupos de inquilinos y de host.
• Para solucionar problemas al configurar una máquina virtual (VM) en Azure Virtual Desktop, consulte Configuración de la máquina virtual del host de sesión.
• Para solucionar problemas con conexiones de cliente de Azure Virtual Desktop, consulte Conexiones de servicios de Azure Virtual Desktop.
• Para solucionar problemas con los clientes de Escritorio remoto, consulte Solución de problemas del cliente de Escritorio remoto.
• Para más información sobre el servicio, consulte Entorno de Azure Virtual Desktop.
• Para realizar un tutorial de solución de problemas, consulte Tutorial: Solución de problemas de las implementaciones de plantillas de Resource Manager.
• Para más información sobre las acciones de auditoría, consulte Operaciones de auditoría con Resource Manager.
• Si desea conocer más detalles sobre las acciones que permiten determinar los errores durante la implementación, consulte Visualización de operaciones de implementación con el Portal de Azure.