PowerShell para Azure Virtual Desktop
Importante
Este contenido se aplica a Azure Virtual Desktop con objetos de Azure Resource Manager. Si usa Azure Virtual Desktop (clásico) sin objetos de 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: New-AzRoleAssignment: "The provided information does not map to an AD object ID" (New-AzRoleAssignment: la información proporcionada no está asignada a ningún id. de objeto de AD).
New-AzRoleAssignment -SignInName "admins@contoso.com" -RoleDefinitionName "Desktop Virtualization User" -ResourceName "0301HP-DAG" -ResourceGroupName 0301RG -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'
Causa: El usuario especificado con el parámetro -SignInName no se encuentra en la instancia de Microsoft Entra vinculada al entorno de Azure Virtual Desktop.
Solución: Realice las siguientes comprobaciones:
- El usuario debe sincronizarse con Microsoft Entra ID.
- El usuario no debe estar vinculado con comercios de negocio a consumidor (B2C) ni de negocio a negocio (B2B).
- El entorno de Azure Virtual Desktop debe estar vinculado a la instancia correcta de Microsoft Entra ID.
Error: New-AzRoleAssignment: "El cliente con el id. de objeto no está autorizado para realizar la acción sobre el ámbito (código: AuthorizationFailed)"
Causa 1: la cuenta usada no tiene permisos de propietario en la suscripción.
Corrección 1: un usuario con permisos de propietario debe ejecutar la asignación de roles. Como alternativa, el usuario debe tener asignado el rol de administrador de acceso de usuario para asignar un usuario a un grupo de aplicaciones.
Causa 2: La cuenta usada tiene permisos de propietario, pero no forma parte de la instancia de Microsoft Entra ID del entorno 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.
Error: New-AzWvdHostPool: la ubicación no está disponible para el tipo de recurso
New-AzWvdHostPool_CreateExpanded: The provided location 'southeastasia' is not available for resource type 'Microsoft.DesktopVirtualization/hostpools'. List of available regions for the resource type is 'eastus,eastus2,westus,westus2,northcentralus,southcentralus,westcentralus,centralus'.
Causa: Azure Virtual Desktop permite seleccionar la ubicación de grupos de hosts, grupos de aplicaciones y áreas de trabajo para almacenar metadatos de servicio en determinadas ubicaciones. Las opciones están restringidas en función de dónde esté disponible la característica. Este error significa que la característica no está disponible en la ubicación que ha elegido.
Solución: se publicará una lista de las regiones admitidas en el mensaje de error. Use alguna de las regiones admitidas.
Error: New-AzWvdApplicationGroup debe estar en la misma ubicación que el grupo de hosts.
New-AzWvdApplicationGroup_CreateExpanded: ActivityId: e5fe6c1d-5f2c-4db9-817d-e423b8b7d168 Error: ApplicationGroup must be in same location as associated HostPool
Causa: Hay un error de coincidencia de ubicación. Todos los grupos de hosts, grupos de aplicaciones y áreas de trabajo tienen una ubicación para almacenar los metadatos de servicio. Los objetos que cree que estén asociados entre sí deben estar en la misma ubicación. Por ejemplo, si un grupo de hosts está en eastus
, también debe crear los grupos de aplicaciones en eastus
. Si crea un área de trabajo para registrar estos grupos de aplicaciones, esta también debe estar en eastus
.
Solución: Recupere la ubicación en la que se creó el grupo de hosts y, a continuación, asigne el grupo de aplicaciones que está creando a esa misma ubicación.
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 configuración de grupos de hosts y el entorno de Azure Virtual Desktop, consulte Creación de entornos y grupos de hosts.
- 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 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.