安装 AppStream 2.0 客户端并为用户自定义客户端体验

以下各节介绍如何安装 AppStream 2.0 客户端以及如何为用户自定义客户端体验。如果您计划为您的用户下载并安装客户端，请先下载企业部署工具。然后，您可以运行 PowerShell 脚本来安装 AppStream 2.0 客户端并远程配置客户端设置。

下载企业部署工具

企业部署工具包括 AppStream 2.0 客户端安装文件和组策略管理模板。

1. 要下载企业部署工具，请在支持的AppStream 2.0 客户端页面的右下角选择企业部署工具链接。该链接打开一个 .zip 文件，其中包含该工具的最新版本所需的文件。

2. 要提取所需文件，请导航到下载该工具的位置，右键单击 AmazonAppStreamClientEnterpriseSetup_ <version>文件夹，然后选择全部解压缩。该文件夹包含两个安装程序和一个组策略管理模板：

   • AppStream 2.0 客户端安装程序 (AmazonAppStreamClientSetup_ <version>.msi) — 安装 AppStream 2.0 客户端。

   • AppStream 2.0 USB 驱动程序安装程序 (AmazonAppStreamUsbDriverSetup_ <version>.exe) — 安装 AppStream 2.0 USB 驱动程序，该驱动程序是将 USB 设备与通过 AppStream 2.0 传输的应用程序一起使用所必需的。

   • AppStream 2.0 客户端组策略管理模板 (as2_client_config.adm) — 允许您通过组策略配置 AppStream 2.0 客户端。

安装 AppStream 2.0 客户端和 USB 驱动程序

下载 AppStream 2.0 客户端安装文件后，在用户的计算机上运行以下 PowerShell 脚本以静默安装 AppStream 2.0 客户端安装文件 AppStreamClient .exe 和 USB 驱动程序。

注意

要运行此脚本，您必须使用“Administrator (管理员)”权限登录到适用的计算机。您还可以在启动时在“System (系统)”账户下远程运行脚本。

Start-Process msiexec.exe -Wait -ArgumentList  '/i AmazonAppStreamClientSetup_<version>.msi /quiet'

Start-Process AmazonAppStreamUsbDriverSetup_<version>.exe -Wait -ArgumentList  '/quiet'

在用户的计算机上安装企业部署工具后， AppStream 2.0 客户端的安装如下所示：

1. AppStream 2.0 客户端安装文件被复制到用户计算机上的以下路径中：C:\Program Files (x86)\ Amazon AppStream 2.0 Client Installer\AppStreamClient .exe。

2. 安装企业部署工具后，用户首次登录其计算机时，即安装了 AppStream 2.0 客户端。

   注意

   如果企业部署工具检测到 %localappdata% 中已经存在 AppStream 2.0 客户端文件夹，则该工具不会安装客户端。AppStreamClient

如果用户卸载 AppStream 2.0 客户端，则在您更新 AppStream 2.0 企业部署工具之前，不会再次安装该客户端。

使用 AppStream 2.0 客户端访问 AppStream 2.0

默认情况下，当用户启动 AppStream 2.0 客户端时，他们只能连接到包含 AppStream 2.0 域的 URL 或包含启用连接的 DNS TXT 记录的域。您可以通过执行以下任一操作让客户端用户访问 AppStream 2.0 域以外的域：

• 设置 StartURL 注册表值以指定用户可以访问的自定义 URL，例如组织的登录门户的 URL。

• 设置 TrustedDomains 注册表值以指定用户可以访问的受信任域。

• 创建 AS2TrustedDomains DNS TXT 记录以指定用户可以访问的受信任域。可利用此方法来避免注册表更改。

注意

AppStream 2.0 客户端和 DNS TXT 记录配置不会阻止用户使用其他连接方法访问您指定的域或 URL。例如，如果用户具有对域或 URL 的网络访问权限，则可使用 Web 浏览器访问指定的域或 URL。

为 AppStream 2.0 客户端用户设置 starTurl 注册表值

您可以使用StartUrl注册表值来设置用户启动 AppStream 2.0 客户端时填充在 2.0 客户端中的自定义 URL。可以在安装客户端时创建此 HKLM 注册表项，以便用户在启动客户端时无需指定 URL。

安装 AppStream 2.0 客户端后，您可以运行以下 PowerShell 脚本来创建此注册表项，也可以使用 AppStream 2.0 客户端企业部署工具中包含的管理模板通过组策略配置客户端。

将 StartUrl 值替换为您的身份提供商 (IdP) 的 URL。该 URL 必须使用受设备信任的证书。这意味着 StartUrl 网页使用的证书必须包含一个包括 URL 的域名的使用者备用名称 (SAN)。例如，如果您的 StartUrl 设置为 https://appstream.example.com，则 SSL 证书必须包含一个包括 appstream.example.com 的 SAN。

注意

要运行此脚本，您必须使用“Administrator (管理员)”权限登录到适用的计算机。您还可以在启动时在“System (系统)”账户下远程运行脚本。

$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "StartUrl" -Value "https://www.example.com" -PropertyType String -Force | Out-Null

将 TrustedDomains 注册表值设置为 AppStream 2.0 客户端启用其他域

您可以将 AppStream 2.0 客户端配置为连接到您指定的可信域中的 URL。例如，您可能希望允许用户连接到组织域中的任何 URL，或连接到一个或多个 IdP 域中的任何 URL。在指定 URL 时，使用以下格式：*.example-idp.com。

您可以逗号分隔格式指定受信任域的列表。将此列表作为注册表值添加到 AppStream 2.0TrustedDomains HKLM 注册表项中。我们建议您在安装 AppStream 2.0 客户端时创建此注册表项并指定可信域列表，如果您使用的是 Microsoft Active Directory，则通过组策略指定可信域列表。这样，您的用户可以在安装客户端后立即连接到任何受信任域中的 URL。

安装 AppStream 2.0 客户端后，您可以运行以下 PowerShell 脚本来创建此注册表项。或者，您可以使用 AppStream 2.0 客户端企业部署工具中包含的管理模板通过组策略配置客户端。

将 TrustedDomains 值替换为一个或多个组织域或 IdP 域的逗号分隔列表。受信任域网页使用的证书必须包含一个包括 URL 的域的 SAN。例如，如果您的受信任域包含 *.example.com，并且用户指定 https://appstream.example.com，则 SSL 证书必须包含一个包括 appstream.example.com 的 SAN。

注意

要运行此脚本，您必须使用“Administrator (管理员)”权限登录到适用的计算机。您还可以在启动时在“System (系统)”账户下远程运行脚本。

$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "TrustedDomains" -Value "*.example1.com, *.example2.com, aws.amazon.com" -PropertyType String -Force | Out-Null

以下是格式化受信任域名的要求和注意事项。

• 支持以下字符：a-z、0-9、-、*

• DNS 会根据 * 字符出现在域名中的位置将它作为通配符或作为星号字符 (ASCII 42) 来处理。以下是在 DNS 记录名称中使用 * 作为通配符时的限制：

  • * 必须替换域名中最左侧的标签。例如，*.example.com 或 *.prod.example.com。如果在任何其他位置包含 *（例如 prod.*.example.com），DNS 会将其视为星号字符 (ASCII 42)，而不是通配符。

  • * 必须替换整个标签。例如，您不能指定 *prod.example.com 或 prod*.example.com。

  • * 应用到包含 * 的子域级别以及该子域的所有子域。例如，如果条目名为 *.example.com，则 AppStream 2.0 客户端允许 zenith.example.com、acme.zenith.example.com 和 pinacle.acme.zenith.example.com。

创建 AS2TrustedDomains DNS TXT 记录以在不更改注册表的情况下为 AppStream 2.0 客户端启用您的域名

可以通过在组织域或 IdP 域中创建 DNS TXT 记录，来允许用户连接到组织域（例如，*.example.com）中的任何 URL或 IdP 域（例如，*.example-idp.com）中的任何 URL。在创建 DNS TXT 记录时，无需 StartURL 或 TrustedDomains 注册表值即可允许用户连接到 URL。

您可以逗号分隔格式并使用前缀 AS2TrustedDomains= 指定受信任子域的列表。然后，为相应的域创建 DNS TXT 记录。AS2TrustedDomains DNS TXT 记录只能启用相同的域，或在其中创建 DNS TXT 记录的域的子域。无法使用 DNS TXT 记录启用其他域。

注意

在创建 DNS TXT 记录时，任何用户均可从未包含在 StartURL 或 TrustedDomains 注册表值的已启用域进行流式传输。 AppStream 2.0 客户端和 DNS TXT 记录配置不会阻止用户使用其他连接方法访问您指定的域或 URL。例如，如果用户具有对域或 URL 的网络访问权限，则可使用 Web 浏览器访问指定的域或 URL。

DNS TXT 记录配置示例

以下是 DNS TXT 记录配置的示例。使用本示例的配置，用户可以启动 AppStream 2.0 客户端并连接到 appstream.example.com 或 appstream-dev.example.com。但是，他们无法连接到 example.com。

• Domains to enable— appstream.example.com，appstream-dev.example.com

• DNS TXT record location— example.com

• DNS TXT record value— AS2TrustedDomains =appstream.example.com，appstream-dev.example.com

要求和注意事项

请记住以下有关创建 DNS TXT 记录的要求和注意事项：

• 您必须在二级域创建 TXT 记录。例如，如果您的域为 prod.appstream.example.com，则必须在 example.com 创建 DNS TXT 记录。

• TXT 记录值必须以 AS2TrustedDomains= 开头

• 支持以下字符：a-z、0-9、-、*

• DNS 会根据 * 字符出现在域名中的位置将它作为通配符或作为星号字符 (ASCII 42) 来处理。以下是在 DNS 记录名称中使用 * 作为通配符时的限制：

  • * 必须替换域名中最左侧的标签。例如，*.example.com 或 *.prod.example.com。如果在任何其他位置包含 *（例如 prod.*.example.com），DNS 会将其视为星号字符 (ASCII 42)，而不是通配符。

  • * 必须替换整个标签。例如，您不能指定 *prod.example.com 或 prod*.example.com。

  • * 应用到包含 * 的子域级别以及该子域的所有子域。例如，如果条目名为 *.example.com，则 AppStream 2.0 客户端允许连接到以下域：zenith.example.com、acme.zenith.example.com 和 pinacle.acme.zenith.example.com。

为受信任域禁用 DNS TXT 记录查找

默认情况下，当用户启动 AppStream 2.0 并指定非 AppStream 2.0 域的 URL 时，客户端会执行 DNS TXT 记录查询。在 URL 的二级域上执行查找，以便客户端能够确定该域是否包含在 AS2TrustedDomains 列表中。此行为允许用户连接到未在StartURL或TrustedDomains注册表项中指定的域或 AppStream 2.0 域。

可以通过将 DnsTxtRecordQueryDisabled 注册表项的值设置为 true 来禁用此行为。您可以在安装 AppStream 2.0 客户端时创建此注册表项。这样一来，客户端便只会连接到 StartURL 或 TrustedDomains 注册表项所指定的 URL。

安装 AppStream 2.0 客户端后，您可以运行以下 PowerShell脚本来创建此注册表项。或者，您可以使用 AppStream 2.0 客户端企业部署工具中包含的管理模板通过组策略配置客户端。

注意

要运行此脚本，您必须使用“Administrator (管理员)”权限登录到适用的计算机。您还可以在启动时在“System (系统)”账户下远程运行脚本。

$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force
 
New-ItemProperty -Path $registryPath -Name "DnsTxtRecordQueryDisabled" -Value "true" -PropertyType String -Force | Out-Null

选择是否禁用自动客户端更新

默认情况下，当 AppStream 2.0 客户端的新版本可用时，客户端会自动更新到最新版本。您可以通过将AutoUpdateDisabled注册表项的值设置为来禁用自动更新true。您可以在安装 AppStream 2.0 客户端时创建此注册表项。这样，每当有新版本时，客户端不会自动更新。

安装 AppStream 2.0 客户端后，您可以运行以下 PowerShell 脚本来创建此注册表项。或者，您可以使用 AppStream 2.0 客户端企业部署工具中包含的管理模板通过组策略配置客户端。

注意

要运行此脚本，您必须使用“Administrator (管理员)”权限登录到适用的计算机。您还可以在启动时在“System (系统)”账户下远程运行脚本。

$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "AutoUpdateDisabled" -Value "True" -PropertyType String -Force | Out-Null

选择是否禁用按需诊断日志上传

默认情况下， AppStream 2.0 客户端允许用户按需将诊断日志和小转储上传到 AppStream 2.0 (AWS)。此外，如果出现异常或 AppStream 2.0 客户端停止响应，则会提示用户选择是否要上传 minidump 和相关日志。有关按需诊断日志记录的更多信息，请参阅自动和按需诊断日志上传。

您可以通过将UserUploadOfClientLogsAllowed注册表项的值设置为来禁用这些行为false。您可以在安装 AppStream 2.0 客户端时创建此 HKLM 注册表项。

安装 AppStream 2.0 客户端后，您可以运行以下 PowerShell 脚本来创建此注册表项。或者，您可以使用 AppStream 2.0 客户端企业部署工具中包含的管理模板通过组策略配置客户端。

注意

要运行此脚本，您必须使用“Administrator (管理员)”权限登录到适用的计算机。您还可以在启动时在“System (系统)”账户下远程运行脚本。

$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "UserUploadOfClientLogsAllowed" -Value "false" -PropertyType String -Force | Out-Null

选择是否禁用原生应用程序模式

默认情况下， AppStream 2.0 客户端可以在经典模式或本机应用程序模式下运行。您可以通过将NativeAppModeDisabled注册表项的值设置为来禁用本机应用程序模式true。您可以在安装 AppStream 2.0 客户端时创建此 HKLM 注册表项。如果该值设置为 true，则客户端仅在经典模式下运行。有关原生应用程序模式的信息，请参阅原生应用程序模式。

安装 AppStream 2.0 客户端后，您可以运行以下 PowerShell脚本来创建此注册表项。或者，您可以使用 AppStream 2.0 客户端企业部署工具中包含的管理模板通过组策略配置客户端。

注意

要运行此脚本，您必须使用“Administrator (管理员)”权限登录到适用的计算机。您还可以在启动时在“System (系统)”账户下远程运行脚本。

$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "NativeAppModeDisabled" -Value "True" -PropertyType String -Force | Out-Null

选择是否禁用本地打印机重定向

默认情况下， AppStream 2.0 客户端允许用户将打印作业从其流媒体应用程序重定向到连接到本地计算机的打印机。您可以通过将PrinterRedirectionDisabled注册表项的值设置为来禁用本地打印机重定向true。您可以在安装 AppStream 2.0 客户端时创建此 HKLM 注册表项。如果该值设置为true，则客户端不会将打印作业从用户的流媒体应用程序重定向到连接到其本地计算机的打印机。

安装 AppStream 2.0 客户端后，可以运行以下 PowerShell 脚本来创建此注册表项。或者，您可以使用 AppStream 2.0 客户端企业部署工具中包含的管理模板通过组策略配置客户端。

注意

要运行此脚本，您必须使用“Administrator (管理员)”权限登录到适用的计算机。您还可以在启动时在“System (系统)”账户下远程运行脚本。

$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "PrinterRedirectionDisabled" -Value "True" -PropertyType String -Force | Out-Null

选择是否禁用智能卡重定向

默认情况下， AppStream 2.0 客户端的智能卡重定向处于启用状态。启用此功能后，用户可以在不使用 USB 重定向的情况下在 AppStream 2.0 流媒体会话期间使用连接到本地计算机和智能卡的智能卡读卡器。在 AppStream 2.0 流媒体会话期间，用户的智能卡读卡器和智能卡仍可与本地应用程序一起使用。客户端将智能卡 API 调用从用户的流媒体应用程序重定向到他们的本地智能卡。您可以通过将SmartCardRedirectionDisabled注册表项的值设置为来禁用智能卡重定向true。您可以在安装 AppStream 2.0 客户端时创建此 HKLM 注册表项。

如果将该值设置为true，则在没有 USB 重定向的情况下，您的用户将无法在 AppStream 2.0 流式传输会话期间使用其智能卡读卡器和智能卡。在这种情况下，除非您对设备进行认证，否则用户无法使用连接到本地计算机的智能卡登录其流媒体应用程序。在您对设备进行资格认证后，用户必须与 AppStream 2.0 共享该设备。禁用智能卡重定向后，在用户的 AppStream 2.0 流式传输会话期间，其智能卡读卡器和智能卡无法用于本地应用程序。

安装 AppStream 2.0 客户端后，可以运行以下 PowerShell 脚本来创建此注册表项。或者，您可以使用 AppStream 2.0 客户端企业部署工具中包含的管理模板通过组策略配置客户端。

注意

要运行此脚本，您必须使用“Administrator (管理员)”权限登录到适用的计算机。您还可以在启动时在“System (系统)”账户下远程运行脚本。

$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "SmartCardRedirectionDisabled" -Value "True" -PropertyType String -Force | Out-Null

为您的用户配置其他 AppStream 2.0 客户端设置

AppStream 2.0 客户端使用注册表项配置以下附加客户机设置：

• AppStream 2.0 接受客户最终用户许可协议 (EULA)

• AppStream 2.0 客户端 EULA 版本已接受

• AppStream 2.0 客户端的自动诊断日志上传

• 自动更新用于将 USB 驱动程序传递到 AppStream 2.0 的 USB 驱动程序

• 在 AppStream 2.0 客户端中启用硬件渲染

• 在 AppStream 2.0 客户端中为文件系统重定向设置自定义文件夹路径

下表汇总了其他客户端设置的注册表值，您可以使用这些设置为用户自定义 AppStream 2.0 客户端体验。

注意

这些值区分大小写。

值	注册表路径	类型	描述	数据
EULAAccepted	HKCU\Software\Amazon\Appstream Client	字符串	将此值设置true为代表您的用户接受 AppStream 2.0 客户端 EULA。	true/false
AcceptedEULAVersion	HKCU\Software\Amazon\Appstream Client	字符串	接受的 EULA 的版本。如果 AppStream 2.0 客户端 EULA 的当前版本与接受的 EULA 版本不同，则会提示用户接受 EULA 的当前版本。	1.0
DiagnosticInfoCollectionAllowed	HKCU\Software\Amazon\Appstream Client	字符串	将此值设置为true ，以启用 AppStream 2.0 自动将诊断日志从 AppStream 2.0 客户端发送到 AppStream 2.0 (AWS)。	true/false
USBDriverOptIn	HKCU\Software\Amazon\Appstream Client	字符串	将此值设置为true，启用 AppStream 2.0 自动更新用于将 USB 驱动程序传递到 AppStream 2.0 的 USB 驱动程序。	true/false
HardwareRenderingEnabled	HKCU\Software\Amazon\Appstream Client	字符串	将此值设置为true，可在 AppStream 2.0 客户端中启用硬件渲染。	true/false
FileRedirectionCustomDefaultFolders	HKCU\Software\Amazon\Appstream Client	字符串	将此值设置为包括至少一个用于文件系统重定向的文件夹路径。使用“|”分隔多个文件夹路径。默认情况下，将会指定以下文件夹路径：%USERPROFILE%\Desktop|%USERPROFILE%\Documents|%USERPROFILE%\Downloads	有效的文件夹路径

安装 AppStream 2.0 客户端后，您可以运行以下 PowerShell 脚本来创建这些注册表项。如果您不想创建所有注册表项，请根据需要修改脚本以仅创建所需的注册表项。或者，您可以使用 AppStream 2.0 客户端企业部署工具中提供的管理模板通过组策略配置客户端。

注意

您必须为每个用户设置以下条目。

$registryPath="HKCU:\Software\Amazon\AppStream Client"
New-Item -Path "HKCU:\Software\Amazon" -Name "AppStream Client" -Force
New-ItemProperty -Path $registryPath -Name "EULAAccepted" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "AcceptedEULAVersion" -Value "1.0" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "DiagnosticInfoCollectionAllowed" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "USBDriverOptIn" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "HardwareRenderingEnabled" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "FileRedirectionCustomDefaultFolders" -Value "%USERPROFILE%\Desktop|%USERPROFILE%\Documents|%USERPROFILE%\Downloads" -PropertyType String -Force | Out-Null

使用组策略自定义 AppStream 2.0 客户端体验

您可以使用 AppStream 2.0 客户端企业部署工具中提供的管理模板通过组策略配置客户端。要了解如何将管理模板加载到组策略管理控制台中，请参阅 Microsoft 支持文档中的管理组策略管理模板 (.adm) 文件的建议。