本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # WorkSpaces 集區的套件和映像 *WorkSpace 套件*是作業系統、儲存體、運算和軟體資源的組合。當您啟動 WorkSpace 時，請選取符合您需求的套件。WorkSpaces 可用的預設套件稱為*公用套件*。如需有關可用於 WorkSpaces 之各種公用套件的詳細資訊，請參閱 [Amazon WorkSpaces 套件](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles)。 如果您已啟動 Windows WorkSpace 並自訂它，您可以從該 WorkSpace 建立自訂映像，以便與 WorkSpaces 集區搭配使用。WorkSpaces 集區不支援 Linux。 *自訂映像*僅包含 WorkSpace 的作業系統、軟體和設定。*自訂套件*是該自訂映像和可從中啟動 WorkSpace 之硬體的組合。 建立自訂映像後，您可以建置自訂套件，以結合自訂 WorkSpace 映像和您選取的基礎運算和儲存體組態。然後，您可以在建立新的 WorkSpaces 集區時指定此自訂套件，以確保集區中的新 WorkSpaces 具有相同的一致組態 （硬體和軟體）。 如果您需要執行軟體更新或在 WorkSpaces 上安裝其他軟體，您可以更新自訂套件並使用它來重新建置 WorkSpaces。 WorkSpaces 集區支援數種不同的作業系統 (OS)、串流通訊協定和套件。下表提供每個作業系統支援的授權、串流通訊協定和套件的相關資訊。 | 作業系統 | 授權 | 串流通訊協定 | 支援的套件 | 生命週期政策/淘汰日期 | | --- | --- | --- | --- | --- | | Windows Server 2019 | 包含 | DCV | 值、標準、效能、電源、PowerPro | [2029 年 1 月 9 日](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2019) | | Windows Server 2022 | 包含 | DCV | 標準、效能、Power、PowerPro、Graphics.G4dn、GraphicsPro.G4dn | [2031 年 10 月 14 日](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2022) | **注意** 廠商不再支援的作業系統版本不保證可正常運作，也不支援 AWS 支援。 **Topics** + [WorkSpaces 集區的套件選項](pools-custom-images-bundles.md) + [建立 WorkSpaces 集區的自訂映像和套件](pools-images-custom-image.md) + [管理 WorkSpaces 集區的自訂映像和套件](pools-images-managing.md) + [使用工作階段指令碼來管理使用者的串流體驗](pools-images-session-scripts.md) # WorkSpaces 集區的套件選項 在選取要與 WorkSpaces 集區搭配使用的套件之前，請確定您要選取的套件與您 WorkSpaces 的通訊協定、作業系統、網路和運算類型相容。建議執行並使用可複寫使用者日常工作的應用程式，以測試您要在測試環境中選擇的套件效能。如需通訊協定的詳細資訊，請參閱 [WorkSpaces Personal 的通訊協定](amazon-workspaces-networking.md#amazon-workspaces-protocols)。如需網路的詳細資訊，請參閱[WorkSpaces Personal 的用戶端網路需求](workspaces-network-requirements.md)。 下列公有套件可與 WorkSpaces 集區搭配使用。如需 WorkSpaces 中套件的相關資訊，請參閱 [Amazon WorkSpaces 套件](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles)。Value、Standard、Performance、Power、PowerPro ## 超值套件 此套件非常適合下列各項： + 基本文字編輯和資料輸入 + 輕度使用的網頁瀏覽 + 即時訊息 不建議將此套件用於文字處理、音訊和視訊會議、螢幕共用、軟體開發工具、商業智慧應用程式和圖形應用程式。 ## 標準套件 此套件非常適合下列各項： + 基本文字編輯和資料輸入 + 網頁瀏覽 + 即時訊息 + 電子郵件 不建議將此套件用於音訊和視訊會議、螢幕共用、文字處理、軟體開發工具、商業智慧應用程式和圖形應用程式。 ## 效能套件 此套件非常適合下列各項： + 網頁瀏覽 + 文字處理 + 即時訊息 + 電子郵件 + 試算表 + 音訊處理 + 課程教材 不建議將此套件用於視訊會議、螢幕共用、軟體開發工具、商業智慧應用程式和圖形應用程式 ## Power 套件 此套件非常適合下列各項： + 網頁瀏覽 + 文字處理 + 電子郵件 + 即時訊息 + 試算表 + 音訊處理 + 軟體開發 (整合式開發環境 (IDE)) + 入門到中級資料處理 + 音訊和視訊會議 不建議將此套件用於螢幕共用、軟體開發工具、商業智慧應用程式和圖形應用程式。 ## PowerPro 套件 此套件非常適合下列各項： + 網頁瀏覽 + 文字處理 + 電子郵件 + 即時訊息 + 試算表 + 音訊處理 + 軟體開發 (整合式開發環境 (IDE)) + 資料倉儲 + 商業智慧應用程式 + 音訊和視訊會議 不建議將此套件用於機器學習模型訓練和圖形應用程式 ## Graphics.g4dn 套件 此套件為 WorkSpaces 提供高層級的圖形效能，以及中等層級的 CPU 效能和記憶體，非常適合下列各項： + 網頁瀏覽 + 文字處理 + 電子郵件 + 試算表 + 即時訊息 + 音訊會議 + 軟體開發 (整合式開發環境 (IDE)) + 入門到中級資料處理 + 資料倉儲 + 商業智慧應用程式 + 圖形設計 + CAD/CAM (電腦輔助設計/電腦輔助製造) 不建議將此套件用於音訊和視訊會議、3D 轉譯、相片寫實風格設計和機器學習模型訓練 ## GraphicsPro.g4dn 套件 此套件可為 WorkSpaces 提供高等級的圖形效能、CPU 效能和記憶體，非常適合下列各項： + 網頁瀏覽 + 文字處理 + 電子郵件 + 試算表 + 即時訊息 + 音訊會議 + 軟體開發 (整合式開發環境 (IDE)) + 入門到中級資料處理 + 資料倉儲 + 商業智慧應用程式 + 圖形設計 + CAD/CAM (電腦輔助設計/電腦輔助製造) + 視訊轉碼 + 3D 轉譯 + 相片寫實風格設計 + 遊戲串流 + ML (機器學習) 模型訓練與 ML 推論 不建議將此套件用於音訊和視訊會議。 # 建立 WorkSpaces 集區的自訂映像和套件 WorkSpaces 集區僅支援 Windows 映像和套件。如果您已啟動 Windows 或 WorkSpace 並自訂它，您可以從該 WorkSpace 建立自訂映像和自訂套件。 *自訂映像*僅包含 WorkSpace 的作業系統、軟體和設定。*自訂套件*是該自訂映像與可從中啟動 WorkSpace 之硬體的組合。 建立自訂映像後，您可以建置自訂套件，其結合自訂映像以及您選取的基礎運算和儲存組態。然後，您可以在啟動新的 WorkSpaces 時指定此自訂套件，以確保新的 WorkSpaces 具有相同的一致組態 (硬體和軟體)。 藉由為每個套件選取不同的運算和儲存選項，您可使用相同的自訂映像來建立各種自訂套件。 **重要** 自訂套件儲存磁碟區不能小於映像儲存磁碟區。 自訂套件的成本與其建立的公有套件相同。如需定價的詳細資訊，請參閱 [Amazon WorkSpaces 定價](https://aws.amazon.com/workspaces/pricing/)。 **Topics** + [建立 Windows 自訂映像的需求](#pools-windows_custom_image_requirements) + [最佳實務](#pools-custom_image_best_practices) + [步驟 1：執行映像檢查程式](#pools-run_image_checker) + [步驟 2：建立自訂映像和自訂套件](#pools-create_custom_image_bundle) + [Windows WorkSpaces 自訂映像所包含的內容](#pools-image_creation_windows) ## 建立 Windows 自訂映像的需求 **注意** Windows 目前將 1 GB 定義為 1,073,741,824 個位元組。您必須確保它們在 C 磁碟機上沒有超過 12，884，901，888 個位元組 （或 12 GiB)，而且使用者設定檔小於 10，737，418，240 個位元組 （或 10 GiB)，才能建立 WorkSpace 的映像。 + WorkSpace 的狀態必須為**可用**，且其修改狀態必須為**無**。 + WorkSpaces 映像上的所有應用程式和使用者設定檔都必須與 Microsoft Sysprep 相容。 + 要包含在映像中的所有應用程式都必須安裝在 `C` 磁碟機上。 + 在 WorkSpace 上執行的所有應用程式服務都必須使用本機系統帳戶，而非網域使用者認證。例如，您不能使用網域使用者的認證執行 Microsoft SQL Server Express 安裝。 + WorkSpace 不得加密。目前不支援從加密的 WorkSpace 建立映像。 + 映像中需要下列元件。若沒有這些元件，您從映像啟動的 WorkSpaces 將無法正常運作。如需詳細資訊，請參閱[WorkSpaces Personal 所需的組態和服務元件](required-service-components.md)。 + Windows PowerShell 3.0 版或更新版本 + 遠端桌面服務 + AWS PV 驅動程式 + Windows 遠端管理 (WinRM) + Teradici PCoIP 代理程式和驅動程式 + STXHD 代理程式和驅動程式 + AWS 和 WorkSpaces 憑證 + Skylight 代理程式 + WorkSpaces 集區僅支援 200 GB 的最大套件/映像根磁碟區大小。當您建立 Windows 自訂映像時，請確定其根磁碟區大小低於 200 GB。 ## 最佳實務 在您從 WorkSpace 建立映像之前，請執行下列操作： + 使用未連線到生產環境的個別 VPC。 + 在私有子網路中部署 WorkSpace 並將 NAT 執行個體用於輸出流量。 + 使用小型 Simple AD 目錄。 + 使用來源 WorkSpace 的最小磁碟區大小，然後在建立自訂套件時視需要調整磁碟區大小。 + 在 WorkSpace 上安裝所有作業系統更新 (Windows 功能/版本更新除外) 和所有應用程式更新。 + 從 WorkSpace 中刪除不應包含在套件中的快取資料 (例如，瀏覽器歷史記錄、快取檔案和瀏覽器 cookie)。 + 從 WorkSpace 中刪除不應包含在套件中的組態設定 (例如，電子郵件設定檔)。 + 使用 DHCP 切換到動態 IP 地址設定。 + 確保您尚未超過區域中允許的 WorkSpace 映像配額。根據預設，您在每個區域中允許有 40 個 WorkSpace 映像。如果您已達到此配額，建立映像的新嘗試將會失敗。若要請求提高配額，請使用 [WorkSpaces 限制表單](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=workspaces)。 + 請確定您並未嘗試從加密的 WorkSpace 建立映像。目前不支援從加密的 WorkSpace 建立映像。 + 如果您在 WorkSpace 上執行任何防毒軟體，請在嘗試建立映像時將其停用。 + 如果您在 WorkSpace Spaces 上啟用了防火牆，請確保它不會封鎖任何必要的連接埠。如需詳細資訊，請參閱[WorkSpaces Personal 的 IP 位址和連接埠要求](workspaces-port-requirements.md)。 + 對於 Windows WorkSpaces，請勿在建立映像之前設定任何群組政策物件 (GPO)。 + 對於 Windows WorkSpaces，請勿在建立映像之前自訂預設使用者設定檔 (`C:\Users\Default`)。建議您透過 GPO 對使用者設定檔進行任何自訂，並在建立映像之後套用自訂。GPO 可輕易地加以修改或回復，因此比對預設使用者設定檔進行的自訂更不容易發生錯誤。 + 確保更新 WorkSpaces 上的聯網相依性驅動程式，例如 ENA、NVMe 和 PV 驅動程式。您應該至少每 6 個月執行一次此操作。如需詳細資訊，請參閱[安裝或升級彈性網路轉接器 (ENA) 驅動程式 ](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/enhanced-networking-ena.html#ena-adapter-driver-install-upgrade-win)、[AWS NVMe 驅動程式 適用於 Windows 執行個體](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/aws-nvme-drivers.html)的 ，以及[升級 Windows 執行個體上的 PV 驅動程式](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Upgrading_PV_drivers.html)。 + 請務必定期將 EC2Config, EC2Launch 和 EC2Launch V2 代理程式更新為最新版本。您應該至少每 6 個月執行一次此操作。如需詳細資訊，請參閱[更新 EC2Config 和 EC2Launch](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/migrating-latest-types.html#upgdate-ec2config-ec2launch)。 ## 步驟 1：執行映像檢查程式 若要確認您的 Windows WorkSpace 符合建立映像的需求，建議您執行映像檢查程式應用程式。映像檢查程式會在您要用來建立映像的 WorkSpace 上執行一系列測試，並提供如何解決所發現的任何問題的指引。映像檢查程式僅適用於 Windows WorkSpaces。 **重要** WorkSpace 必須先通過映像檢查程式執行的所有測試，才能使用它來建立映像。 在您執行映像檢查程式之前，請確認您的 WorkSpace 上已安裝最新的 Windows 安全和累積更新。 若要取得映像檢查程式，請執行下列其中一項操作： + [重新啟動 WorkSpace](reboot-workspaces.md)。映像檢查程式會在重新啟動期間自動下載並安裝於 `C:\Program Files\Amazon\ImageChecker.exe`。 + 從 [https://tools.amazonworkspaces.com/ImageChecker.zip](https://tools.amazonworkspaces.com/ImageChecker.zip) 下載 Amazon WorkSpaces 映像檢查程式，然後將 `ImageChecker.exe` 檔案解壓縮。將此檔案複製到 `C:\Program Files\Amazon\`。 **若要執行映像檢查程式** 1. 開啟 `C:\Program Files\Amazon\ImageChecker.exe` 檔案。 1. 在 **Amazon WorkSpaces 映像檢查程式**對話方塊中，選擇**執行**。 1. 每次測試完成後，您可以檢視測試的狀態。 對於狀態為**失敗**的任何測試，請選擇**資訊**以顯示如何解決造成失敗之問題的相關資訊。如需有關如何解決這些問題的資訊，請參閱 [用以解決映像檢查程式偵測到的問題的秘訣](#pools-image_checker_tips)。 如果有任何測試顯示**警告**狀態，請選擇**修正所有警告**按鈕。 此工具會在映像檢查程式所在的相同目錄中產生輸出日誌檔。此檔案的預設位置為 `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`。請勿刪除此日誌檔案。如果發生問題，此日誌檔可能有助於疑難排解。 1. 如果適用，請解決導致測試失敗和警告的任何問題，並重複執行映像檢查程式的程序，直到 WorkSpace 通過所有測試為止。您必須先解決所有失敗和警告，才能建立映像。 1. 在 WorkSpace 通過所有測試之後，您會看到**驗證成功**訊息。您現在可以建立自訂套件。 ### 用以解決映像檢查程式偵測到的問題的秘訣 除了諮詢下列秘訣以解決映像檢查程式偵測到的問題之外，務必檢閱映像檢查程式日誌檔，網址為 `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`。 #### 必須安裝 PowerShell 3.0 版或更新版本 安裝最新版的 [Microsoft Windows PowerShell](https://docs.microsoft.com/powershell)。 **重要** 必須將 WorkSpace 的 PowerShell 執行政策設定為允許 **RemoteSigned** 指令碼。若要檢查執行政策，請執行 **Get-ExecutionPolicy** PowerShell 命令。如果執行政策未設定為**不受限制**或 **RemoteSigned**，請執行 **Set-ExecutionPolicy – ExecutionPolicy RemoteSigned** 命令，以變更執行政策的值。**RemoteSigned** 設定允許在 Amazon WorkSpaces 上執行指令碼，這是建立映像所需的指令碼。 #### 只有 C 和 D 磁碟機可以存在 只有 `C` 和 `D` 磁碟機可存在於用來製作映像的 WorkSpace 上。移除所有其他磁碟機，包括虛擬磁碟機。 #### 無法偵測到由於 Windows Update 的擱置中重新啟動 + 直到 Windows 重新啟動以完成安裝安全或累積更新，才能執行「建立映像」程序。重新啟動 Windows 以套用這些更新，並確定不需要安裝其他擱置中的 Windows 安全或累積更新。 + 不支援在從某個 Windows 10 版本升級到較新 Windows 10 版本 (Windows 功能/版本升級) 的 Windows 10 系統上建立映像。不過，WorkSpaces 映像建立程序支援 Windows 累積或安全性更新。 #### Sysprep 檔案必須存在且不能空白 如果您的 Sysprep 檔案有問題，請聯絡 [AWS 支援 中心](https://console.aws.amazon.com/support/home#/)，以修復 EC2Config 或 EC2Launch。 #### 使用者設定檔大小必須少於 10 GB 對於 Windows 7 WorkSpaces，使用者設定檔 (`D:\Users\username`) 總計必須少於 10 GB。視需要移除檔案，以減少使用者設定檔的大小。 #### 磁碟機 C 必須有足夠的可用空間 對於 Windows 7 WorkSpaces，您必須在磁碟機 `C` 上至少有 12 GB 的可用空間。視需要移除檔案以釋放磁碟機 `C` 上的空間。對於 Windows 10 WorkSpaces，如果您收到 `FAILED` 訊息且磁碟空間超過 2GB，請忽略。 #### 任何服務都不能在網域帳戶下執行 若要執行「建立映像」程序，WorkSpace 上的任何服務都不能在網域帳戶下執行。所有服務都必須在本機帳戶下執行。 **若要在本機帳戶下執行服務** 1. 開啟 `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log` 並尋找在網域帳戶下執行的服務清單。 1. 在 Windows 搜尋方塊中，輸入 **services.msc** 以開啟 Windows Services Manager。 1. 在**登入身分**之下，尋找在網域帳戶下執行的服務。(以**本機系統**、**本機服務**或**網路服務**形式執行的服務不會干擾映像建立。) 1. 選取在網域帳戶下執行的服務，然後依序選擇**動作**、**內容**。 1. 開啟**登入**索引標籤。在**登入身分**之下，選擇**本機系統帳戶**。 1. 選擇**確定**。 #### 必須將 WorkSpace 設定為使用 DHCP 您必須將 WorkSpace 上的所有網路介面卡設定為使用 DHCP，而非靜態 IP 地址。 **若要將所有網路介面卡設定為使用 DHCP** 1. 在 Windows 搜尋方塊中，輸入 **control panel** 以開啟「控制台」。 1. 選擇**網路和網際網路**。 1. 選擇**網路和共用中心**。 1. 選擇**變更介面卡設定**，然後選取介面卡。 1. 選擇**變更此連線的設定**。 1. 在**網路**索引標籤上，選取**網際網路通訊協定第 4 版 (TCP/IPv4)**，然後選擇**內容**。 1. 在**網際網路通訊協定第 4 版 (TCP/IPv4) 內容**對話方塊中，選取**自動取得 IP 地址**。 1. 選擇**確定**。 1. 對 WorkSpace 上的所有網路介面卡重複此程序。 #### 必須啟用遠端桌面服務 「建立映像」程序需要啟用遠端桌面服務。 **若要啟用遠端桌面服務** 1. 在 Windows 搜尋方塊中，輸入 **services.msc** 以開啟 Windows Services Manager。 1. 在**名稱**欄中，尋找**遠端桌面服務**。 1. 選取**遠端桌面服務**，然後依序選擇**動作**、**內容**。 1. 在**一般**索引標籤上，針對**啟動類型**選擇**手動**或**自動**。 1. 選擇**確定**。 #### 使用者設定檔必須存在 您用來建立映像的 WorkSpace 必須具有使用者設定檔 (`D:\Users\username`)。如果測試失敗，請聯絡 [AWS 支援 中心](https://console.aws.amazon.com/support/home#/)尋求協助。 #### 環境變數路徑必須設定正確 本機電腦的環境變數路徑缺少 System32 和 Windows PowerShell 的項目。執行「建立映像」時需要這些項目。 **若要設定環境變數路徑** 1. 在 Windows 搜尋方塊中，輸入 **environment variables**，然後選擇**編輯系統環境變數**。 1. 在**系統內容**對話方塊中，開啟**進階**索引標籤，然後選擇**環境變數**。 1. 在**環境變數**對話方塊的**系統變數**之下，選取**路徑**項目，然後選擇**編輯**。 1. 選擇**新增**，然後新增下列路徑： `C:\Windows\System32` 1. 再次選擇**新增**，然後新增下列路徑： `C:\Windows\System32\WindowsPowerShell\v1.0\` 1. 選擇**確定**。 1. 重新啟動 WorkSpace。 **提示** 項目出現在環境變數路徑中的順序很重要。若要判斷正確的順序，您可以比較 WorkSpace 的環境變數路徑與新建立的 WorkSpace 或新 Windows 執行個體中的環境變數路徑。 #### 必須啟用 Windows Modules Installer 「建立映像」程序需要啟用 Windows Modules Installer 服務。 **若要啟用 Windows Modules Installer 服務** 1. 在 Windows 搜尋方塊中，輸入 **services.msc** 以開啟 Windows Services Manager。 1. 在**名稱**欄中，尋找 **Windows Modules Installer**。 1. 選取 **Windows Modules Installer**，然後依序選擇**動作**、**內容**。 1. 在**一般**索引標籤上，針對**啟動類型**選擇**手動**或**自動**。 1. 選擇**確定**。 #### 必須停用 Amazon SSM Agent 「建立映像」程序需要停用 Amazon SSM Agent 服務。 **若要停用 Amazon SSM Agent 服務** 1. 在 Windows 搜尋方塊中，輸入 **services.msc** 以開啟 Windows Services Manager。 1. 在**名稱**欄中，尋找 **Amazon SSM Agent**。 1. 選取 **Amazon SSM Agent**，然後依序選擇**動作**、**內容**。 1. 在**一般**索引標籤上，針對**啟動類型**，選擇**停用**。 1. 選擇**確定**。 #### 必須啟用 SSL3 和 TLS 1.2 版 若要設定 Windows 的 SSL/TLS，請參閱 Microsoft Windows 文件中的[如何啟用 TLS 1.2](https://docs.microsoft.com/configmgr/core/plan-design/security/enable-tls-1-2)。 #### WorkSpace 上只能存在一個使用者設定檔 您用來建立映像的 WorkSpace 上只能有一個 WorkSpaces 使用者設定檔 (`D:\Users\username`)。刪除不屬於 WorkSpace 預定使用者的任何使用者設定檔。 若要能夠建立映像，您的 WorkSpace 只能有三個使用者設定檔： + WorkSpace 預定使用者的使用者設定檔 (`D:\Users\username`) + 預設使用者設定檔 (也稱為「預設設定檔」) + 管理員使用者設定檔 如果有其他使用者設定檔，您可以透過 Windows 控制台中的進階系統內容將其刪除。 **若要刪除使用者設定檔** 1. 若要存取進階系統內容，請執行下列其中一項操作： + 按 **Windows 鍵\$1Pause Break**，然後在**控制台** > **系統和安全性** > **系統**對話方塊的左窗格中選擇**進階系統設定**。 + 在 Windows 搜尋方塊中，輸入 **control panel**。在 [控制台] 中，選擇**系統和安全性**，然後選擇 [系統]，然後在**控制台** > **系統和安全性系統** > **系統**對話方塊的左窗格中選擇 **進階系統設定**。 1. 在**系統內容**對話方塊的**進階**索引標籤上，選擇**使用者設定檔**之下的**設定**。 1. 如果除了管理員設定檔、預設設定檔及預定 WorkSpaces 使用者的設定檔以外，還列出任何設定檔，請選取該額外設定檔，然後選擇**刪除**。 1. 當系統詢問您是否要刪除設定檔時，請選擇**是**。 1. 如有必要，請重複步驟 3 和 4 以移除不屬於 WorkSpace 的任何其他設定檔。 1. 選擇**確定**兩次，然後關閉控制台。 1. 重新啟動 WorkSpace。 #### 任何 AppX 套件都不能處於暫存狀態 一或多個 AppX 套件處於暫存狀態。這可能在建立映像期間造成 Sysprep 錯誤。 **若要移除所有暫存 AppX 套件** 1. 在 Windows 搜尋方塊中，輸入 **powershell**。選擇**以管理員身分執行**。 1. 當系統詢問「您要允許此應用程式對裝置進行變更嗎？」時，請選擇**是**。 1. 在 Windows PowerShell 視窗中，輸入下列命令以列出所有暫存 AppX 套件，然後在每個套件之後按 Enter 鍵。 ``` $workSpaceUserName = $env:username ``` ``` $allAppxPackages = Get-AppxPackage -AllUsers ``` ``` $packages = $allAppxPackages | Where-Object { ` (($_.PackageUserInformation -like "*S-1-5-18*" -and !($_.PackageUserInformation -like "*$workSpaceUserName*")) -and ` ($_.PackageUserInformation -like "*Staged*" -or $_.PackageUserInformation -like "*Installed*")) -or ` ((!($_.PackageUserInformation -like "*S-1-5-18*") -and $_.PackageUserInformation -like "*$workSpaceUserName*") -and ` $_.PackageUserInformation -like "*Staged*") } ``` 1. 以更高的 SYSTEM 權限執行下列命令，以移除所有暫存 AppX 套件佈建項目，然後按 Enter 鍵。 ``` $packages | Remove-AppxPackage -ErrorAction SilentlyContinue ``` 1. 再次執行映像檢查程式。如果此測試仍然失敗，請輸入下列命令以移除所有 AppX 套件，並在每個套件之後按 Enter 鍵。 ``` Get-AppxProvisionedPackage -Online | Remove-AppxProvisionedPackage -Online -ErrorAction SilentlyContinue ``` ``` Get-AppxPackage -AllUsers | Remove-AppxPackage -ErrorAction SilentlyContinue ``` #### Windows 不得從以前的版本升級 不支援在從某個 Windows 10 版本升級到較新 Windows 10 版本 (Windows 功能/版本升級) 的 Windows 系統上建立映像。 若要建立映像，請使用尚未進行 Windows 功能/版本升級的 WorkSpace。 #### Windows 重設授權計數不得為 0 重設授權功能允許您延長 Windows 試用版的啟用期間。建立映像程序要求重設授權計數必須是 0 以外的值。 **若要檢查 Windows 重設授權計數** 1. 在 Windows **Start (開始)** 功能表，選擇 **Windows System (Windows 系統)**，然後選擇 **Command Prompt (命令提示字元)**。 1. 在命令提示視窗中，輸入以下命令，然後按 Enter 鍵。 `cscript C:\Windows\System32\slmgr.vbs /dlv` 若要將重設授權計數重設為 0 以外的值，請參閱 Microsoft Windows 文件中的 [Sysprep (一般化) Windows 安裝](https://docs.microsoft.com/windows-hardware/manufacture/desktop/sysprep--generalize--a-windows-installation)。 #### 其他疑難排解秘訣 如果您的 WorkSpace 通過映像檢查程式執行的所有測試，但仍無法從 WorkSpace 建立映像，請檢查下列問題： + 請確定 WorkSpace 未指派給**網域訪客**群組中的使用者。若要檢查是否有任何網域帳戶，請執行下列 PowerShell 命令。 ``` Get-WmiObject -Class Win32_Service | Where-Object { $_.StartName -like "*$env:USERDOMAIN*" } ``` + 在 Windows 執行個體設定期間，當 EC2Config 服務或 EC2Launch 指令碼請求 RDP 憑證指紋時，有些群組政策物件 (GPO) 會限制對 RDP 憑證指紋的存取。在您嘗試建立映像之前，請將 WorkSpace 移至已封鎖繼承且未套用 GPO 的新組織單位 (OU)。 + 請確定 Windows 遠端管理 (WinRM) 服務已設定為自動啟動。請執行下列操作： 1. 在 Windows 搜尋方塊中，輸入 `services.msc` 以開啟 Windows Services Manager。 1. 在**名稱**欄中，尋找 **Windows 遠端管理 (WS-管理)**。 1. 選取 **Windows 遠端管理 (WS-管理)**，然後依序選擇**動作**、**內容**。 1. 在**一般**索引標籤上，針對**啟動類型**，選擇**自動**。 1. 選擇**確定**。 ## 步驟 2：建立自訂映像和自訂套件 驗證 WorkSpace 映像之後，請完成下列程序，以使用 WorkSpaces 主控台建立自訂映像和自訂套件。若要以程式設計方式建立映像，請使用 CreateWorkspaceImage API 動作。如需詳細資訊，請參閱《*Amazon WorkSpaces * [ WorkSpaces API 參考》中的 CreateWorkspaceImage](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceImage.html)。若要以程式設計方式建立套件，請使用 **CreateWorkspaceBundle** API 動作。如需詳細資訊，請參閱《Amazon WorkSpaces API 參考》**中的 [CreateWorkspaceBundle](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceBundle.html)。 **使用 WorkSpaces 主控台建立自訂映像和自訂套件** 1. 如果您仍然連線至 WorkSpace，請在 WorkSpaces 用戶端應用程式中選擇 **Amazon WorkSpaces** 和**中斷連線**來中斷連線。 1. 在 https：//[https://console.aws.amazon.com/workspaces/v2/home](https://console.aws.amazon.com/workspaces/v2/home) 開啟 WorkSpaces 主控台。 1. 在導覽窗格中，選擇 **WorkSpaces**。 1. 選取 WorkSpace 以開啟其詳細資訊頁面，然後選擇**建立映像**。如果 WorkSpace 的狀態為**已停止**，您必須先加以啟動 (選擇**動作**、**啟動 WorkSpaces**)，然後才能選擇**動作**、**建立映像**。 1. 隨即顯示一則訊息，提示您先重新啟動 WorkSpace，然後繼續執行。重新啟動 WorkSpace 會將 Amazon WorkSpaces 軟體更新為最新版本。 關閉訊息並遵循 [在 WorkSpace WorkSpaces](reboot-workspaces.md) 中的步驟，以重新啟動 WorkSpace。完成後，請重複此程序的[Step 4](create-custom-bundle.md#step_create_image)，但這次在重新啟動訊息出現時選擇**下一步**。若要建立映像，WorkSpace 的狀態必須為**可用**，且其修改狀態必須為**無**。 1. 輸入映像名稱和描述以協助您識別映像，然後選擇**建立映像**。正在建立映像時，WorkSpace 的狀態為**已暫停**且無法使用 WorkSpace。 請勿在描述中使用破折號 (`-`) 特殊字元。這將導致錯誤。 1. 在導覽窗格中，選擇**映像**。當 WorkSpace 的狀態變更為**可用**時，映像即完成 (最多可能需要 45 分鐘)。 1. 選取映像，然後依序選擇**動作**、**建立套件**。 1. 輸入套件名稱和描述，然後執行以下操作： + 針對**套件硬體類型**，選擇從此自訂套件啟動 WorkSpaces 時要使用的硬體。 + 根磁碟區的預設可用大小組合為每個 WorkSpace 200 GB。 1. 若要確認您的套件已建立，請選擇**套件**並確認已列出該套件。 ## Windows WorkSpaces 自訂映像所包含的內容 當您從 Windows WorkSpace 建立映像時，會包含`C`磁碟機的整個內容。 + 聯絡人 + 下載 + 音樂 + 圖片 + 儲存的遊戲 + 影片 + Podcast + 虛擬機器 + .virtualbox + 追蹤 + appdata\$1local\$1temp + appdata\$1roaming\$1apple computer\$1mobilesync\$1 + appdata\$1roaming\$1apple computer\$1logs\$1 + appdata\$1roaming\$1apple computer\$1itunes\$1iphone software updates\$1 + appdata\$1roaming\$1macromedia\$1flash player\$1macromedia.com\$1support\$1flashplayer\$1sys\$1 + appdata\$1roaming\$1macromedia\$1flash player\$1\$1sharedobjects\$1 + appdata\$1roaming\$1adobe\$1flash player\$1assetcache\$1 + appdata\$1roaming\$1microsoft\$1windows\$1recent\$1 + appdata\$1roaming\$1microsoft\$1office\$1recent\$1 + appdata\$1roaming\$1microsoft office\$1live meeting + appdata\$1roaming\$1microsoft shared\$1livemeeting shared\$1 + appdata\$1roaming\$1mozilla\$1firefox\$1crash reports\$1 + appdata\$1roaming\$1mcafee\$1common framework\$1 + appdata\$1local\$1microsoft\$1feeds cache + appdata\$1local\$1microsoft\$1windows\$1temporary internet files\$1 + appdata\$1local\$1microsoft\$1windows\$1history\$1 + appdata\$1local\$1microsoft\$1internet explorer\$1domstore\$1 + appdata\$1local\$1microsoft\$1internet explorer\$1imagestore\$1 + appdata\$1locallow\$1microsoft\$1internet explorer\$1iconcache\$1 + appdata\$1locallow\$1microsoft\$1internet explorer\$1domstore\$1 + appdata\$1locallow\$1microsoft\$1internet explorer\$1imagestore\$1 + appdata\$1local\$1microsoft\$1internet explorer\$1recovery\$1 + appdata\$1local\$1mozilla\$1firefox\$1profiles\$1 # 管理 WorkSpaces 集區的自訂映像和套件 WorkSpaces Personal 和 WorkSpaces 集區之間的自訂映像和套件管理程序相同。如需如何管理映像和套件的詳細資訊，請參閱本指南 WorkSpaces Personal 一節中的下列文件： **注意** 您可用於 WorkSpaces Personal 的自訂套件與可用於 WorkSpaces 集區的自訂套件之間的主要差異，在於可使用的作業系統和基本公有套件。如需 WorkSpaces 集區中支援的作業系統和套件，請參閱 [ WorkSpaces 集區套件套件 了解 WorkSpaces 集區套件。 *WorkSpace 套件*是作業系統、儲存體、運算和軟體資源的組合。當您啟動 WorkSpace 時，請選取符合您需求的套件。WorkSpaces 可用的預設套件稱為*公用套件*。如需有關可用於 WorkSpaces 之各種公用套件的詳細資訊，請參閱 [Amazon WorkSpaces 套件](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles)。 下表提供每個作業系統支援的授權、串流通訊協定和套件的相關資訊。 | 作業系統 | 授權 | 串流通訊協定 | 支援的套件 | | --- | --- | --- | --- | | Windows Server 2019 | 包含 | DCV | 值、標準、效能、電源、PowerPro | | Windows Server 2022 | 包含 | DCV | 標準、效能、電源、PowerPro、Graphics.G4dn、GraphicsPro.G4dn | 廠商不再支援的作業系統版本不保證可正常運作，也不支援 AWS 支援。 ](instance-types.md#instance-types.title)。 + [更新 WorkSpaces Personal 的自訂套件](update-custom-bundle.md). + [在 WorkSpaces Personal 中複製自訂映像](copy-custom-image.md). + [在 WorkSpaces Personal 中共用或取消共用自訂映像](share-custom-image.md). + [在 WorkSpaces Personal 中刪除自訂套件或映像](delete_bundle.md). # 使用工作階段指令碼來管理使用者的串流體驗 WorkSpaces 集區提供執行個體上的工作階段指令碼。當使用者的串流工作階段發生特定事件時，您可以使用這些指令碼來執行您自己的自訂指令碼。例如，您可以在使用者的串流工作階段開始之前，使用自訂指令碼來準備 WorkSpaces 集區環境。在使用者完成其串流工作階段之後，您也可以使用自訂指令碼來清除串流執行個體。 工作階段指令碼是在 WorkSpace 映像中指定。這些指令碼在使用者環境或系統環境之內執行。如果您的工作階段指令碼使用標準輪出來撰寫資訊、錯誤或偵錯訊息，這些都可以選擇性地儲存在您 Amazon Web Services 帳戶內的 Amazon S3 儲存貯體中。 **Topics** + [串流工作階段開始之前執行指令碼](#run-scripts-before-streaming-sessions-begin) + [在串流工作階段結束之後執行指令碼](#run-scripts-after-streaming-sessions-end) + [建立和指定工作階段指令碼](#create-specify-session-scripts) + [工作階段指令碼組態檔案](#session-script-configuration-file) + [使用 Windows PowerShell 檔案](#using-powershell-files-with-session-scripts) + [記錄工作階段指令碼輸出](#logging-session-output) + [搭配工作階段指令碼使用持久性儲存](#use-storage-connectors-with-session-scripts) + [為工作階段指令碼日誌啟用 Amazon S3 儲存貯體儲存](#enable-S3-bucket-storage-session-script-logs) ## 串流工作階段開始之前執行指令碼 您可以設定指令碼來執行最長 60 秒，之後，使用者的應用程式才啟動，他們的串流工作階段才開始。這樣做可讓您在使用者開始串流其應用程式之前自訂 WorkSpaces 集區環境。當工作階段指令碼執行時，使用者會看到載入環。當您的指令碼成功完成或超過最長等待時間後，使用者的串流工作階段就會開始。如果您的指令碼未成功完成，則會顯示錯誤訊息給使用者。但是，不會阻止您的使用者使用其串流工作階段。 當您在 Windows 執行個體上指定檔案名稱時，您必須使用雙反斜線。例如： ``` C:\\Scripts\\Myscript.bat ``` 如果您不使用雙反斜線，則會顯示錯誤，通知您`.json`檔案格式不正確。 **注意** 當您的指令碼成功完成時，必須傳回 0 這個值。如果您的指令碼傳回 0 以外的值，WorkSpaces 會向使用者顯示錯誤訊息。 當您在串流工作階段開始之前執行指令碼時，會發生下列程序： 1. 您的使用者連線到 WorkSpace WorkSpaces。它們使用 SAML 2.0 進行連線。 1. 發生以下其中一項： + 如果已針對使用者啟用應用程式設定持續性，則會下載並掛載應用程式設定虛擬硬碟 (VHD) 檔案，其中存放使用者的自訂項目和 Windows 設定。在這種情況下，需要 Windows 使用者登入。 如需應用程式設定持續性的相關資訊，請參閱[為您的 WorkSpaces 集區使用者啟用應用程式設定持續性](app-settings-persistence.md)。 + 如果應用程式設定持續性未啟用，但 Windows 使用者已登入。 1. 您的工作階段指令碼會開始。如果已針對使用者啟用持久性儲存，則儲存連接器掛載也會開始。如需持久性儲存的相關資訊，請參閱[啟用和管理 WorkSpaces 集區的持久性儲存](persistent-storage.md)。 **注意** 儲存連接器掛載並不需要完成，串流工作階段也會開始。如果工作階段指令碼比儲存連接器掛載更早完成，串流工作階段會開始。 如需有關監控儲存連接器掛載狀態的資訊，請參閱[搭配工作階段指令碼使用持久性儲存](#use-storage-connectors-with-session-scripts)。 1. 您的工作階段指令碼完成或逾時。 1. 使用者的串流工作階段會開始。 ## 在串流工作階段結束之後執行指令碼 您也可以將您的指令碼設定為在使用者的工作階段結束之後執行。例如，當使用者從 WorkSpaces 用戶端工具列選取**結束工作階段**，或當他們達到工作階段允許的持續時間上限時，您可以執行指令碼。您也可以使用這些工作階段指令碼，在串流執行個體終止之前清除 WorkSpaces 環境。例如，您可以使用指令碼來發行檔案鎖定或上傳日誌檔。當您在串流工作階段結束之後執行指令碼時，則處理如下： 1. 使用者的 WorkSpaces 串流工作階段結束。 1. 您的工作階段終止指令碼會開始。 1. 工作階段終止指令碼完成或逾時。 1. 發生 Windows 使用者登出。 1. 以下一項或兩項同時發生 (如果適用)： + 如果已針對使用者啟用應用程式設定持續性，則會卸載應用程式設定 VHD 檔案 (其中存放使用者的自訂項目和 Windows 設定)，並上傳到您帳戶中的 Amazon S3 儲存貯體。 + 如果已針對使用者啟用持久性儲存，則儲存連接器會完成最終同步，然後卸載。 1. WorkSpace 已終止。 ## 建立和指定工作階段指令碼 完成下列程序，為 WorkSpaces 集區中的 WorkSpaces 建立和指定工作階段指令碼。 1. 連線至您要從中建立自訂映像的 Windows WorkSpaces。 1. `/AWSEUC/SessionScripts` 如果目錄尚未存在，請建立目錄。 1. `/AWSEUC/SessionScripts/config.json` 如果組態檔案尚未存在，請使用[工作階段指令碼組態範本](https://docs.aws.amazon.com/workspaces/latest/adminguide/pools-images-session-scripts.html#session-script-configuration-file)建立組態檔案。 1. 導覽至 `C:\AWSEUC\SessionScripts` 並開啟 `config.json` 組態檔案。 如需工作階段指令碼參數的相關資訊，請參閱[工作階段指令碼組態檔案](#session-script-configuration-file)。 1. 完成變更之後，儲存並關閉 `config.json` 檔案。 1. 完成從 WorkSpace 建立映像的步驟。如需詳細資訊，請參閱[建立 WorkSpaces 集區的自訂映像和套件](pools-images-custom-image.md)。 ## 工作階段指令碼組態檔案 若要在 Windows 執行個體中找到工作階段指令碼組態檔案，請導覽至 `C:\AWSEUC\SessionScripts\config.json`。檔案的格式如下所示。 **注意** 組態檔案為 JSON 格式。確認您在此檔案中輸入的任何文字為有效的 JSON 格式。 ``` { "SessionStart": { "executables": [ { "context": "system", "filename": "", "arguments": "", "s3LogEnabled": true }, { "context": "user", "filename": "", "arguments": "", "s3LogEnabled": true } ], "waitingTime": 30 }, "SessionTermination": { "executables": [ { "context": "system", "filename": "", "arguments": "", "s3LogEnabled": true }, { "context": "user", "filename": "", "arguments": "", "s3LogEnabled": true } ], "waitingTime": 30 } } ``` 您可以在工作階段指令碼組態檔案中使用以下參數。 **`SessionStart/SessionTermination `** 在適當的工作階段事件中根據物件名稱執行的工作階段指令碼。 **類型：**字串 **必要**：否 **允許的值：****SessionStart**、**SessionTermination** **`WaitingTime`** 工作階段指令碼的最長持續時間 (以秒為單位)。 **類型**：整數 **必要**：否 **限制：**最長持續時間為 60 秒。如果工作階段指令碼在此期間內未完成，則會停下。如果需要讓指令碼繼續執行，請以單獨程序的形式來加以啟動。 **`Executables`** 要執行的指令碼工作階段的詳細資訊。 **類型：**字串 **必要**：是 **限制：**針對每個工作階段事件可執行的指令碼數量上限為 2 (一個用於使用者環境，另一個用於系統環境)。 **`Context`** 用來執行工作階段指令碼的環境。 **類型：**字串 **必要**：是 **允許的值：****user**、**system** **`Filename`** 要執行的工作階段指令碼的完整路徑。如果未指定此參數，則工作階段指令碼不會執行。 **類型：**字串 **必要**：否 **限制：**檔案名稱和完整路徑的最大長度為 1,000 個字元。 **允許的值：****.bat**、**.exe**、 **.sh** 您也可以使用 Windows PowerShell 檔案。如需詳細資訊，請參閱[使用 Windows PowerShell 檔案](#using-powershell-files-with-session-scripts)。 **`Arguments`** 工作階段指令碼或可執行檔的引數。 **類型：**字串 **必要**：否 **長度限制：**長度上限為 1,000 個字元。 **`S3LogEnabled`** 當此參數的值設為 **True** 時，您的 Amazon Web Services 帳戶內會建立 S3 儲存貯體，以存放工作階段指令碼所建立的日誌。依預設，此值是設為 **True**。如需詳細資訊，請參閱本主題稍後的*記錄工作階段指令碼輸出*一節。 **類型**：布林值 **必要**：否 **允許的值：****True**、**False** ## 使用 Windows PowerShell 檔案 若要使用 Windows PowerShell 檔案，請在 `filename` 參數中指定 PowerShell 檔案的完整路徑： ``` "filename": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe", ``` 然後，在 **arguments** 參數中指定您的工作階段指令碼： ``` "arguments": "-File \"C:\\path\\to\\session\\script.ps1\"", ``` 最後，確認 PowerShell 執行政策允許您的 PowerShell 檔案執行。 ## 記錄工作階段指令碼輸出 在組態檔案中啟用此選項時，WorkSpaces 集區會自動從寫入標準輸出的工作階段指令碼擷取輸出。此輸出會上傳到您帳戶中的 Amazon S3 儲存貯體。您可以檢閱日誌檔以進行故障排除或偵錯。 **注意** 當工作階段指令碼傳回一個值，或 **WaitingTime** 中設定值已超過時 (以先到者為準)，就會上傳日誌檔。 ## 搭配工作階段指令碼使用持久性儲存 當 WorkSpaces 持久性儲存啟用時，儲存會在工作階段啟動指令碼執行時開始掛載。如果您的指令碼依賴掛載的持久性儲存，您可以等待連接器可用。WorkSpaces 會在 Windows WorkSpaces 的 Windows 登錄檔中維護儲存連接器的掛載狀態，金鑰如下： ``` HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\AWSEUC\Storage\\ ``` 登錄機碼值如下： + 提供的使用者名稱：透過存取模式提供的使用者 ID。每個模式的存取模式和值如下： + 使用者集區：使用者的電子郵件地址 + 串流 URL：UserID + SAML：NameID。如果使用者名稱包含斜線 (例如，網域使用者的 SAMAccountName)，斜線會換成 "-" 字元。 + 儲存連接器：為使用者啟用的持久性儲存選項的連接器。儲存連接器值如下： + HomeFolder 每個儲存連接器登錄機碼都會包含 **MountStatus** DWORD 值。下表列出可能的 **MountStatus** 值。 **注意** 若要檢視這些登錄機碼，您的映像必須安裝 Microsoft .NET Framework 4.7.2 版或更新版本。 | Value | Description | | --- | --- | | 0 | 未針對此使用者啟用儲存連接器 | | 1 | 儲存連接器掛載正在進行中 | | 2 | 儲存連接器掛載成功 | | 3 | 儲存連接器掛載失敗 | | 4 | 儲存連接器掛載已啟用，但尚未掛載 | ## 為工作階段指令碼日誌啟用 Amazon S3 儲存貯體儲存 當您在工作階段指令碼組態中啟用 Amazon S3 記錄時，WorkSpaces 集區會從工作階段指令碼擷取標準輸出。此輸出會定期上傳到您的 Amazon Web Services 帳戶內的 S3 儲存貯體。對於每個 AWS 區域，WorkSpaces 集區會在您的帳戶中建立專屬於您的帳戶和區域的儲存貯體。 您不需要執行任何設定任務來管理這些 S3 儲存貯體。它們完全由 WorkSpaces 服務管理。存放在每個儲存貯體中的日誌檔在傳輸中會使用 Amazon S3 的 SSL 端點加密，靜態時則使用 Amazon S3 的受管加密金鑰加密。儲存貯體使用特定格式命名，如下所示： ``` wspool-logs---random-identifier ``` **``** 這是在工作階段指令碼日誌中啟用 Amazon S3 儲存貯體儲存的情況下建立 WorkSpaces 集區的 AWS 區域代碼。 **``** 您的 Amazon Web Services 帳戶識別符。隨機 ID 可確保與該區域中的其他儲存貯體不發生衝突。儲存貯體名稱的第一部分 `wspool-logs`，不會因為跨帳戶或區域而變更。 例如，如果您在美國西部 （奧勒岡） 區域 (`us-west-2`) 中於帳戶號碼 的映像中指定工作階段指令碼`123456789012`，WorkSpaces 集區會在帳戶中建立 Amazon S3 儲存貯體，並顯示名稱。只有具備足夠許可的管理員可以刪除這個儲存貯體。 ``` wspool-logs-us-west-2-1234567890123-abcdefg ``` 停用工作階段指令碼不會刪除存放在 S3 儲存貯體中的日誌檔案。您或具有足夠許可的其他管理員必須使用 Amazon S3 主控台或 API，才能永久刪除日誌檔。WorkSpaces 集區會新增儲存貯體政策，以防止意外刪除儲存貯體。 當工作階段指令碼啟用時，將會為每個啟動的串流工作階段建立唯一資料夾。 在您的帳戶中，日誌檔存放在 S3 儲存貯體中的資料夾路徑使用以下結構： ``` //////SessionScriptsLogs/ ``` ****** 存放工作階段指令碼的 S3 儲存貯體名稱。名稱格式如本節前文所述。 ****** 工作階段的來源堆疊名稱。 ****** 工作階段指令碼執行所在的 WorkSpaces 集區名稱。 ***<存取模式>*** 使用者的身分方法：`custom`適用於 WorkSpaces API 或 CLI、`federated`適用於 SAML，以及`userpool`適用於使用者集區中的使用者。 ****** 使用者特定的資料夾名稱。此名稱是使用從使用者識別符產生的小寫 SHA-256 雜湊十六進位字串建立。 ****** 使用者串流工作階段的識別符。每個使用者串流工作階段都會產生唯一 ID。 ****** 產生工作階段指令碼日誌的事件。事件值為：`SessionStart` 和 `SessionTermination`。 以下範例資料夾結構適用於從 test-stack 和 test-fleet 開始的串流工作階段。工作階段使用來自 之 `testuser@mydomain.com` AWS 帳戶 ID 的使用者 ID 的 API`123456789012`，以及美國西部 （奧勒岡） 區域中的設定群組 `test-stack` ()`us-west-2`： ``` wspool-logs-us-west-2-1234567890123-abcdefg/test-stack/test-fleet/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/05yd1391-4805-3da6-f498-76f5x6746016/SessionScriptsLogs/SessionStart/ ``` 在此範例資料夾結構中，一個日誌檔用於使用者環境工作階段開始指令碼，另一個日誌檔用於系統環境工作階段開始指令碼 (如果適用)。