为用户设置远程桌面 Web 客户端

项目
07/03/2024
适用于:

✅ Windows Server 2025, ✅ Windows Server 2022, ✅ Windows Server 2019, ✅ Windows Server 2016

远程桌面 Web 客户端使用户可以通过兼容的 Web 浏览器访问组织的远程桌面基础结构。无论他们身在何处，都能够如同使用本地电脑一样与远程应用或桌面进行交互。设置了远程桌面 Web 客户端后，用户只需要可以用于访问客户端的 URL、其凭据以及受支持的 Web 浏览器，便可开始使用。

重要

Web 客户端支持使用 Microsoft Entra 应用程序代理，但不支持 Web 应用程序代理。有关详细信息，请参阅将 RDS 与应用程序代理服务结合使用。

设置 Web 客户端所需的条件

开始之前，请记住以下事项：

确保远程桌面部署具有在 Windows Server 2016 或 2019年上运行的 RD 网关、RD 连接代理和 RD Web 访问。
确保部署针对每用户客户端访问许可证 (CAL)（而不是每设备）进行配置，否则会使用所有许可证。
在 RD 网关上安装 Windows 10 KB4025334 更新。更高版本的累积更新可能已包含此 KB。
确保为 RD 网关和 RD Web 访问角色配置了公共受信任证书。
确保用户将连接到的任何计算机都在运行以下操作系统版本之一：
- Windows 10 或更高版本
- Windows Server 2016 或更高版本

用户在连接到 Windows Server 2016（或更高版本）和 Windows 10（版本 1611 或更高版本）时会获得更好的性能。

重要

如果在预览期间使用了 Web 客户端并安装了低于 1.0.0 的版本，则必须先卸载旧客户端，然后再迁移到新版本。如果收到指示“Web 客户端在安装时使用了较旧版本的 RDWebClientManagement，必须先删除再部署新版本”的错误，请按照以下步骤操作：

打开提升的 PowerShell 提示符。
运行 Uninstall-Module RDWebClientManagement 以卸载新模块。
关闭并重新打开提升的 PowerShell 提示符。
运行 Install-Module RDWebClientManagement -RequiredVersion <旧版本>以安装旧模块。
运行 Uninstall-RDWebClient 以卸载旧 Web 客户端。
运行 Uninstall-Module RDWebClientManagement 以卸载旧模块。
关闭并重新打开提升的 PowerShell 提示符。
按如下所示继续执行正常安装步骤。

如何发布远程桌面 Web 客户端

若要首次安装 Web 客户端，请按照以下步骤操作：

在 RD 连接代理服务器上，获取用于远程桌面连接的证书并将它导出为 .cer 文件。将 .cer 文件从 RD 连接代理复制到运行 RD Web 角色的服务器。
在 RD Web 访问服务器上，打开提升的 PowerShell 提示符。
在 Windows Server 2016 上，更新 PowerShellGet 模块，因为收件箱版本不支持安装 Web 客户端管理模块。若要更新 PowerShellGet，请运行以下 cmdlet：
```
Install-Module -Name PowerShellGet -Force
```
注意

若要访问 PowerShell 库，需要传输层安全性 (TLS) 1.2 或更高版本。使用以下命令在 PowerShell 会话中启用 TLS 1.2：
```
[Net.ServicePointManager]::SecurityProtocol =
[Net.ServicePointManager]::SecurityProtocol -bor
[Net.SecurityProtocolType]::Tls12
```
重要

需要先重启 PowerShell，然后更新才能生效，否则模块可能无法正常工作。
使用此 cmdlet 从 PowerShell 库安装远程桌面 Web 客户端管理 PowerShell 模块：
```
Install-Module -Name RDWebClientManagement
```
在此之后，运行以下 cmdlet，以下载远程桌面 Web 客户端的最新版本：
```
Install-RDWebClientPackage
```
接下来，运行此 cmdlet，将括号括起来的值替换为从 RD 代理复制的 .cer 文件的路径：
```
Import-RDWebClientBrokerCert <.cer file path>
```
最后，运行此 cmdlet 以发布远程桌面 Web 客户端：
```
Publish-RDWebClientPackage -Type Production -Latest
```
确保可以使用服务器名称，通过 Web 客户端 URL 访问 Web 客户端，格式为 https://server_FQDN/RDWeb/webclient/index.html。务必在 URL 中使用与 RD Web 访问公共证书匹配的服务器名称（通常是服务器 FQDN）。

注意

运行 Publish-RDWebClientPackage cmdlet 时，可能会看到一个警告，指出不支持每设备 CAL，即使是针对每用户 CAL 配置部署也是如此。如果部署使用每用户 CAL，则可以忽略此警告。我们显示它是为了确保你了解配置限制。
准备好让用户访问 Web 客户端时，只需向他们发送创建的 Web 客户端 URL。

注意

若要查看 RDWebClientManagement 模块支持的所有 cmdlet 的列表，请在 PowerShell 中运行以下 cmdlet：

Get-Command -Module RDWebClientManagement

如何更新远程桌面 Web 客户端

有新版本的远程桌面 Web 客户端可用时，请按照以下这些步骤使用新客户端更新部署：

在 RD Web 访问服务器上打开提升的 PowerShell 提示符并运行以下 cmdlet，以下载最新的可用 Web 客户端版本：
```
Install-RDWebClientPackage
```
（可选）可以通过运行此 cmdlet，在正式版本之前发布客户端进行测试：
```
Publish-RDWebClientPackage -Type Test -Latest
```
客户端应出现在与 Web 客户端 URL 对应的测试 URL 上（例如，<https://server_FQDN/RDWeb/webclient-test/index.html>）。
通过运行以下 cmdlet 来为用户发布客户端：
```
Publish-RDWebClientPackage -Type Production -Latest
```
这会在所有用户重新启动网页时替换其客户端。

如何卸载远程桌面 Web 客户端

若要删除 Web 客户端的所有踪迹，请按照以下步骤操作：

在 RD Web 访问服务器上，打开提升的 PowerShell 提示符。
取消发布测试和生产客户端，卸载所有本地程序包并删除 Web 客户端设置：
```
Uninstall-RDWebClient
```
卸载远程桌面 Web 客户端管理 PowerShell 模块：
```
Uninstall-Module -Name RDWebClientManagement
```

如何在没有 Internet 连接的情况下安装远程桌面 Web 客户端

请按照以下步骤将 Web 客户端部署到没有 Internet 连接的 RD Web 访问服务器。

注意

可以在版本 1.0.1 及更高版本的 RDWebClientManagement PowerShell 模块中进行安装而不需要 Internet 连接。

注意

仍然需要具有 Internet 访问权限的管理员电脑以下载所需文件，然后将它们传输到脱机服务器。

注意

最终用户电脑目前需要 Internet 连接。在未来版本的客户端中会解决此问题以提供完全脱机方案。

通过具有 Internet 访问权限的设备

打开 PowerShell 提示符。
从 PowerShell 库导入远程桌面 Web 客户端管理 PowerShell 模块：
```
Import-Module -Name RDWebClientManagement
```
下载最新版本的远程桌面 Web 客户端以便在另一个设备上安装：
```
Save-RDWebClientPackage "C:\WebClient\"
```

下载最新版本的 RDWebClientManagement PowerShell 模块：

Find-Module -Name "RDWebClientManagement" -Repository "PSGallery" | Save-Module -Path "C:\WebClient\"

将“C:\WebClient”的内容复制到 RD Web 访问服务器。

通过 RD Web 访问服务器

按照如何发布远程桌面 Web 客户端下的说明操作（将步骤 4 和 5 替换为以下内容）。

可以使用两个选项来检索最新的 Web 客户端管理 PowerShell 模块：
- 导入远程桌面 Web 客户端管理 PowerShell 模块：
```
Import-Module -Name RDWebClientManagement
```
- 将下载的 RDWebClientManagement 文件夹复制到 $env:psmodulePath 下列出的某个本地 PowerShell 模块文件夹，或将下载的文件所在文件夹的路径添加到 $env:psmodulePath。
从本地文件夹部署最新版本的远程桌面 Web 客户端（替换为相应的 zip 文件）：
```
Install-RDWebClientPackage -Source "C:\WebClient\rdwebclient-1.0.1.zip"
```

在 Windows Server 2019 中连接到 RD 代理而不使用 RD 网关

此部分介绍如何在 Windows Server 2019 中实现与 RD 代理的 Web 客户端连接而不使用 RD 网关。

设置 RD 代理服务器

如果没有证书绑定到 RD 代理服务器，请按照以下这些步骤操作

打开服务器管理器>远程桌面服务。
在部署概述部分中，选择任务下拉菜单。
选择编辑部署属性，一个标题为部署属性的新窗口会打开。
在部署属性窗口中，选择左侧菜单中的证书。
在证书级别列表中，选择 RD 连接代理 – 启用单一登录。有两个选项：(1) 创建新证书或 (2) 使用现有证书。

如果之前有绑定到 RD Broker 服务器的证书，请按照以下步骤操作

打开绑定到代理的证书，然后复制指纹值。
若要将此证书绑定到安全端口 3392，请打开提升的 PowerShell 窗口并运行以下命令（将 "< thumbprint >" 替换为上一步中复制的值）：
```
netsh http add sslcert ipport=0.0.0.0:3392 certhash="<thumbprint>" certstorename="Remote Desktop" appid="{00000000-0000-0000-0000-000000000000}"
```
注意

若要检查证书是否已正确绑定，请运行以下命令：
```
netsh http show sslcert
```
在 SSL 证书绑定列表中，确保正确的证书已绑定到端口 3392。
打开 Windows 注册表 (regedit)，转到 HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\RDP-Tcp 并找到键 WebSocketURI。接下来，将值设置为“https://+:3392/rdp/”。

设置 RD 会话主机

如果 RD 会话主机服务器与 RD 代理服务器不同，请按照以下这些步骤操作：

为 RD 会话主机计算机创建证书，打开它并复制指纹值。
若要将此证书绑定到安全端口 3392，请打开提升的 PowerShell 窗口并运行以下命令（将 "< thumbprint >" 替换为上一步中复制的值）：
```
netsh http add sslcert ipport=0.0.0.0:3392 certhash="<thumbprint>" appid="{00000000-0000-0000-0000-000000000000}"
```
注意

若要检查证书是否已正确绑定，请运行以下命令：
```
netsh http show sslcert
```
在 SSL 证书绑定列表中，确保正确的证书已绑定到端口 3392。
打开 Windows 注册表 (regedit)，转到 HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\RDP-Tcp 并找到键 WebSocketURI。值必须设置为 https://+:3392/rdp/。

常规观察

确保 RD 会话主机和 RD 代理服务器在运行 Windows Server 2019。
确保为 RD 会话主机和 RD 代理服务器配置了公共受信任证书。

注意

如果 RD 会话主机和 RD 代理服务器共享相同计算机，则仅设置 RD 代理服务器证书。如果 RD 会话主机和 RD 代理服务器使用不同计算机，则必须使用唯一证书配置两者。
每个证书的使用者可选名称 (SAN) 都必须设置为计算机完全限定的域名 (FQDN)。每个证书的公用名 (CN) 必须与 SAN 匹配。

如何为远程桌面 Web 客户端用户预配置设置

本部分介绍如何使用 PowerShell 为远程桌面 Web 客户端部署配置设置。这些 PowerShell cmdlet 基于组织的安全问题或者工作流控制用户是否能够更改设置。以下设置全都位于 Web 客户端的设置侧面板中。

禁止遥测

默认情况下，用户可以选择启用或禁用收集向 Microsoft 发送的遥测数据。有关 Microsoft 收集的遥测数据的信息，请通过“关于”侧面板中的链接参阅我们的隐私声明。

作为管理员，可以使用以下 PowerShell cmdlet 选择对部署禁止遥测收集：

 Set-RDWebClientDeploymentSetting -Name "SuppressTelemetry" $true

默认情况下，用户可以选择启用或禁用遥测。布尔值 $false 会与默认客户端行为匹配。布尔值 $true 会禁用遥测，并限制用户启用遥测。

远程资源启动方法

注意

此设置目前仅适用于 RDS Web 客户端，不适用于 Azure 虚拟桌面 Web 客户端。

默认情况下，用户可以选择通过以下方法启动远程资源：(1) 在浏览器中或 (2) 下载 .rdp 文件以处理安装在其计算机上的另一个客户端。作为管理员，可以选择使用以下 PowerShell 命令来限制部署的远程资源启动方法：

 Set-RDWebClientDeploymentSetting -Name "LaunchResourceInBrowser" ($true|$false)

默认情况下，用户可以选择任一启动方法。布尔值 $true 会强制用户在浏览器中启动资源。布尔值 $false 会强制用户通过下载 .rdp 文件以处理本地安装的 RDP 客户端来启动资源。

将 RDWebClientDeploymentSetting 配置重置为默认值

若要将部署级 Web 客户端设置重置为默认配置，请运行以下 PowerShell cmdlet，并使用 -name 参数指定要重置的设置：

 Reset-RDWebClientDeploymentSetting -Name "LaunchResourceInBrowser"
 Reset-RDWebClientDeploymentSetting -Name "SuppressTelemetry"

疑难解答

如果用户在首次打开 web 客户端时报告以下任何问题，则以下各部分会告知执行哪些操作来修复它们。

如果在尝试访问 Web 客户端时用户的浏览器显示安全警告，该怎么办

RD Web 访问角色可能未使用受信任的证书。确保使用公开受信任的证书配置 RD Web 访问角色。

如果这不起作用，则 Web 客户端 URL 中的服务器名称可能与 RD Web 证书提供的名称不匹配。确保 URL 使用承载 RD Web 角色的服务器的 FQDN。

如果用户无法使用 Web 客户端连接到资源，即使他们可以查看“所有资源”下的项目，该怎么办

如果用户报告他们无法使用 Web 客户端进行连接，即使他们可以看到列出的资源，请检查以下事项：

RD 网关角色是否正确配置为使用受信任的公共证书？
RD 网关服务器是否安装了所需更新？确保服务器安装了 KB4025334 更新。

如果用户在尝试连接时收到“收到了一个意外的服务器身份验证证书”错误消息，则该消息会显示证书的指纹。使用该指纹搜索 RD 代理服务器的证书管理器，以找到正确的证书。在远程桌面部署属性页面中验证该证书是否配置为用于 RD 代理角色。确保该证书尚未过期之后，将 .cer 文件格式的证书复制到 RD Web 访问服务器并在 RD Web 访问服务器上运行以下命令（将括号括起来的值替换为该证书的文件路径）：

Import-RDWebClientBrokerCert <certificate file path>

使用控制台日志诊断问题

如果无法基于本文中的故障排除说明解决问题，则可以尝试通过在浏览器中观察控制台日志来自行诊断问题来源。 Web 客户端提供了一种方法，可在使用 Web 客户端期间记录浏览器控制台日志活动以帮助诊断问题。

选择右上角的省略号，然后在下拉菜单中导航到关于页面。
在捕获支持信息下，选择开始记录按钮。
在 Web 客户端中执行生成尝试诊断的问题的操作。
导航到关于页面，然后选择停止记录。
浏览器会自动下载一个标题为 RD Console Logs.txt 的 .txt 文件。此文件包含重现目标问题时生成的完整控制台日志活动。

还可以直接通过浏览器访问控制台。控制台通常位于开发人员工具下。例如，可以通过按 F12 键，或是通过选择省略号，然后导航到更多工具>开发人员工具，在 Microsoft Edge 中访问日志。

获取有关 Web 客户端的帮助

如果遇到无法通过使用本文中的信息来解决的问题，可在 Microsoft 技术社区的 Azure 虚拟桌面论坛中报告。

通过