安裝 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 驅動程式，以便搭配透過 AppStream 2.0 串流的應用程式使用 USB 裝置所需的 USB 驅動程式。

   • AppStream 2.0 用戶端群組原則系統管理範本 (as2_client_config.adm) — 可讓您透過群組原則設定 2.0 用戶端。 AppStream

安裝 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 檔案 (x86)\ Amazon AppStream 2.0 用戶端安裝程式\ AppStreamClient .exe。

2. 安裝企業部署工具之後，使用者第一次登入電腦時，就會安裝 AppStream 2.0 用戶端。

   注意

   如果企業部署工具偵測到 AppStream 2.0 用戶端資料夾已存在於 %localappdata% 中，則此工具不會安裝用戶端。AppStreamClient

如果使用者解除安裝 AppStream 2.0 用戶端，則在您更新 AppStream 2.0 企業部署工具之前，不會再次安裝用戶端。

使用 AppStream 2.0 用戶端存取 AppStream 2.0

根據預設，當使用者啟動 AppStream 2.0 用戶端時，他們只能連線至包含啟用連線之 DNS TXT 記錄的 AppStream 2.0 網域或網域的 URL。您可以執行下列任一動作，讓用戶端使用者存取 AppStream 2.0 網域以外的網域：

• 設定 StartURL 登錄值，指定使用者可存取的自訂 URL，例如貴組織的登入入口網站。

• 設定 TrustedDomains 登錄值，指定使用者可存取之受信任的網域。

• 建立 AS2TrustedDomains DNS TXT 記錄，指定使用者可存取之受信任的網域。此方法可避免登錄檔變更。

注意

AppStream 2.0 用戶端和 DNS TXT 記錄組態不會阻止使用者使用其他連線方法來存取您指定的網域或 URL。例如，如果使用者具有網域或 URL 的網路存取權，使用者可使用 Web 瀏覽器來存取指定的網域或 URL。

為 AppStream 2.0 用戶端使用者設定登錄值

您可以使用StartUrl登錄值來設定在使用者啟動用戶端時，在 AppStream 2.0 用戶端中填入的自訂 URL。您可以在安裝用戶端時建立此 HKLM 登錄機碼，這樣使用者就不需要在啟動用戶端時指定 URL。

安裝 AppStream 2.0 用戶端之後，您可以執行下列 PowerShell 指令碼來建立此登錄機碼，或使用 AppStream 2.0 用戶端企業部署工具中包含的系統管理範本，透過群組原則設定用戶端。

將 StartUrl 值換成身分提供者 (IdP) 的 URL。URL 必須使用裝置信任的憑證。也就是說，StartUrl 網頁所使用的憑證必須包含主體別名 (SAN)，其中包括 URL 的網域名稱。例如，如果 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.0 TrustedDomains HKLM 登錄機碼。我們建議您在安裝 AppStream 2.0 用戶端時建立此登錄機碼，並指定受信任的網域清單，或者如果您使用 Microsoft Active Directory，透過群組原則。如此一來，使用者就可以在安裝用戶端之後，立即連線到任何受信任網域中的 URL。

安裝 AppStream 2.0 用戶端之後，您可以執行下列 PowerShell 指令碼來建立此登錄機碼。或者，您可以使用包含在 AppStream 2.0 用戶端企業部署工具中的系統管理範本，透過群組原則設定用戶端。

在您的一或多個組織或 IdP 網域中使用逗號分隔清單取代 TrustedDomains 值。受信任網域網頁所使用的憑證必須包含 SAN，其中包括 URL 的網域。例如，如果受信任的網域包含 *.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 或 *.pro.example.com。如果您在任何其他位置包含 * (例如 prod.*.example.com)，則 DNS 會將其視為星號字元 (ASCII 42)，而不是萬用字元。

  • * 必須取代整個標籤。例如，您無法指定 *prod.example.com 或 prod*.example.com。

  • * 適用於包含 * 的子網域層級，以及該子網域的所有子網域。例如，如果某個項目的名稱為 *.example.com，則 AppStream 2.0 用戶端會允許使用最佳例子。

建立 AS2 TrustedDomains DNS TXT 記錄，以便為 AppStream 2.0 用戶端啟用您的網域，而不需要變更登錄

您可以在網域中建立 DNS TXT 記錄，藉此讓使用者能夠連線到組織網域中的任何 URL (例如 *.example.com)，或連線到 IdP 網域中的任何 URL (例如 *.example-idp.com)。當您建立 DNS TXT 記錄時，使用者不需要 StartURL 或 TrustedDomains 登錄值，即可連線到 URL。

您可以使用逗號分隔格式指定受信任的子網域清單，並加上 AS2TrustedDomains= 字首。然後，建立適當網域的 DNS TXT 記錄。AS2TrustedDomains DNS TXT 記錄只能啟用同一個網域或建立 DNS TXT 記錄之網域的子網域。您無法使用 DNS TXT 記錄來啟用其他網域。

如需有關設定 DNS 記錄的詳細資訊，請參閱使用 Route 53 DNS TXT 記錄啟用 AppStream 2.0 用戶端的組織網域和建立 AS2 TrustedDomains DNS T XT 記錄，將 AppStream 2.0 原生用戶端重新導向至第三方身分識別提供者。

注意

當您建立 DNS TXT 記錄時，任何使用者都可以從不包含在 StartURL 或 TrustedDomains 登錄值的已啟用網域中進行串流。 AppStream 2.0 用戶端和 DNS TXT 記錄組態不會阻止使用者使用其他連線方法來存取您指定的網域或 URL。例如，如果使用者具有網域或 URL 的網路存取權，使用者可使用 Web 瀏覽器來存取指定的網域或 URL。

DNS TXT 記錄組態範例

以下是 DNS TXT 記錄組態的範例。透過此範例的設定，使用者可以啟動 AppStream 2.0 用戶端並連線至 appstream。不過，他們無法連線到 example.com。

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

• DNS TXT record location — example.com

• DNS TXT record value— AS2 TrustedDomains = appstream. 例如. COM, 應用程序流開發.

需求和考量事項

建立 DNS TXT 記錄時，請謹記下列需求和考量事項：

• 您必須在第二層網域建立 TXT 記錄。例如，如果網域是 prod.appstream.example.com，則必須在 example.com 建立 DNS TXT 記錄。

• TXT 記錄值必須以 AS2TrustedDomains= 開始

• 支援使用下列字元：a-z、0-9、-、*

• DNS 會根據 * 字元出現在網域名稱中的位置，將其視為萬用字元或星號字元 (ASCII 42)。下列在 DNS 記錄名稱中使用 * 做為萬用字元的限制：

  • * 必須取代網域名稱最左邊的標籤。例如，*.example.com 或 *.pro.example.com。如果您在任何其他位置包含 * (例如 prod.*.example.com)，則 DNS 會將其視為星號字元 (ASCII 42)，而不是萬用字元。

  • * 必須取代整個標籤。例如，您無法指定 *prod.example.com 或 prod*.example.com。

  • * 適用於包含 * 的子網域層級，以及該子網域的所有子網域。例如，如果某個項目的名稱為 *.example.com，則 AppStream 2.0 用戶端會允許連線至下列網域：例如，例如。

停用受信任網域的 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 用戶端會啟用智慧卡重新導向。啟用此功能時，使用者可以在 AppStream 2.0 串流工作階段期間使用連線至其本機電腦及其智慧卡的智慧卡讀卡機，而不需要 USB 重新導向。在 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 用戶端體驗。

注意

這些值會區分大小寫。

Value	登錄檔路徑	Type	描述	資料
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) 檔案的建議。