PowerShell для Виртуального рабочего стола Azure (классическая версия)

Эта статья поможет устранить ошибки и проблемы, возникающие при использовании PowerShell с Виртуальным рабочим столом Azure. Дополнительные сведения о PowerShell для служб удаленных рабочих столов см. в статье PowerShell для Виртуального рабочего стола Azure.

Предоставление отзыва

Посетите техническое сообщество Виртуального рабочего стола Azure, чтобы обсудить возможности использования службы Виртуального рабочего стола Azure с группой разработчиков и активными участниками сообщества.

Команды PowerShell, используемые во время настройки Виртуального рабочего стола Azure

В этом разделе перечислены команды PowerShell, которые обычно используются при настройке Виртуального рабочего стола Azure, а также способы решения проблем, которые могут возникнуть при их использовании.

Ошибка. Команда Add-RdsAppGroupUser: указанное значение UserPrincipalName уже назначено группе приложений RemoteApp в указанном пуле узлов.

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

Причина. Используемое имя пользователя уже назначено группе приложений другого типа. Пользователи не могут назначаться как удаленному рабочему столу, так и группе приложений RemoteApp в одном пуле узлов сеансов.

Исправление. Если пользователю требуется удаленное приложение и рабочий стол, создайте разные пулы узлов или предоставьте пользователю доступ только к удаленному рабочему столу, что позволит использовать любое приложение на виртуальной машине узла сеанса.

Ошибка: команда Add-RdsAppGroupUser — указанное имя userPrincipalName не существует в идентификаторе Microsoft Entra, связанном с клиентом удаленного рабочего стола.

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

Причина. Пользователь, указанный именем -UserPrincipalName, не может находиться в Microsoft Entra, привязанном к клиенту Виртуального рабочего стола Azure.

Способ исправления. Выполните проверку по пунктам приведенного ниже списка.

• Пользователь синхронизируется с идентификатором Microsoft Entra.
• Пользователь не связан с деятельностью "бизнес-потребитель" (B2C) или "бизнес-бизнес" (B2B).
• Клиент Виртуального рабочего стола Azure привязан к правильному идентификатору Microsoft Entra.

Ошибка. Get-RdsDiagnosticActivities: пользователь не имеет прав для отправки запроса к службе управления.

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

Причина. Параметр-TenantName.

Способ исправления. Выполнить Get-RdsDiagnosticActivities с -TenantName <TenantName>.

Ошибка. Get-RdsDiagnosticActivities: пользователь не имеет прав для отправки запроса к службе управления.

Get-RdsDiagnosticActivities -Deployment -username <username>

Причина. Использование параметра -Deployment.

Способ исправления. Параметр -Deployment можно использовать только администраторам развертывания. Эти администраторы обычно являются членами группы служб удаленных рабочих столов или Виртуального рабочего стола Azure. Измените параметр -Deployment на -TenantName <TenantName>.

Ошибка. New-RdsRoleAssignment: пользователь не имеет прав для отправки запроса к службе управления.

Причина 1. У используемой учетной записи нет разрешений владельца служб удаленных рабочих столов для клиента.

Способ исправления 1. Пользователю с разрешениями владельца служб удаленных рабочих столов необходимо выполнить назначение ролей.

Причина 2. Используемая учетная запись имеет разрешения владельца служб удаленных рабочих столов, но не является частью идентификатора Microsoft Entra или не имеет разрешений на запрос идентификатора Microsoft Entra, где находится пользователь.

Способ исправления 2. Пользователю с разрешениями Active Directory необходимо выполнить назначение ролей.

Ошибка: не удалось удалить SessionHostPool

Эта ошибка обычно возникает при выполнении следующей команды, чтобы попытаться удалить узел сеанса.

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

Причина: если выполнить команду перед удалением конечных объектов пула узлов, она не будет работать.

Решение: выполните следующую команду, чтобы удалить узел сеанса.

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

С помощью команды force вы сможете удалить узел сеансов, даже если в нем есть назначенные пользователи.

Следующие шаги

• Общие сведения об устранении неполадок с Виртуальным рабочим столом Azure и о путях эскалации см. в статье Общие сведения об устранении неполадок, отзывы и поддержка.
• Инструкции по устранению неполадок с созданием клиента и пула узлов в среде Виртуального рабочего стола Azure см. в статье Создание клиента и пула узлов.
• Инструкции по устранению неполадок с настройкой виртуальной машины через Виртуальный рабочий стол Azure см. в статье Настройка виртуальной машины узла сеанса.
• Сведения об устранении неполадок с клиентскими подключениями к Виртуальным рабочим столам Azure см. в статье Подключение к службе "Виртуальный рабочий стол Azure".
• Сведения об устранении неполадок с клиентами Удаленного рабочего стола, см. в статье Устранение неполадок с клиентом удаленного рабочего стола.
• Дополнительные сведения о службе см. в статье Среда Виртуального рабочего стола Azure.
• Сведения об устранении неполадок см . в руководстве по устранению неполадок в развертывании шаблонов Resource Manager.
• Сведения о действиях аудита см. в статье Операции аудита с помощью Resource Manager.
• Дополнительные сведения об определении ошибок во время развертывания см. в статье Просмотр операций развертывания с помощью портала Azure.