本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 串流工作階段開始之前執行指令碼
<a name="run-scripts-before-streaming-sessions-begin"></a>

您可以設定指令碼來執行最長 60 秒，之後，使用者的應用程式才啟動，他們的串流工作階段才開始。這樣做可讓您在使用者開始串流其應用程式之前自訂 WorkSpaces 應用程式環境。當工作階段指令碼執行時，使用者會看到載入環。當您的指令碼成功完成或超過最長等待時間後，使用者的串流工作階段就會開始。如果您的指令碼未成功完成，則會顯示錯誤訊息給使用者。但是，不會阻止您的使用者使用其串流工作階段。

當您在 Windows 執行個體上指定檔案名稱時，您必須使用雙反斜線。例如：

C:\$1\$1Scripts\$1\$1Myscript.bat

如果未使用雙反斜線，便會顯示錯誤來通知您 .json 檔案的格式不正確。

**注意**  
當您的指令碼成功完成時，必須傳回 0 這個值。如果您的指令碼傳回 0 以外的值，WorkSpaces 應用程式會向使用者顯示錯誤訊息。

當您在串流工作階段開始之前執行指令碼，且未啟用 WorkSpaces 應用程式動態應用程式架構時，會發生下列程序：

![\[WorkSpaces Applications workflow diagram showing connection, application selection, and session launch steps.\]](http://docs.aws.amazon.com/zh_tw/appstream2/latest/developerguide/images/session-scripts-without-DAF-non-domain-joined2.png)


1. 您的使用者連線到未加入網域的 WorkSpaces 應用程式機群執行個體。他們使用以下其中一個方法連接：
   + WorkSpaces 應用程式使用者集區
   + SAML 2.0
   + WorkSpaces 應用程式 API

1. 應用程式目錄會顯示在 WorkSpaces 應用程式入口網站中，您的使用者選擇要啟動的應用程式。

1. 發生以下其中一項：
   + 如果已針對使用者啟用應用程式設定持續性，則會下載並掛載應用程式設定虛擬硬碟 (VHD) 檔案，其中存放使用者的自訂項目和 Windows 設定。在這種情況下，需要 Windows 使用者登入。

     如需應用程式設定持續性的相關資訊，請參閱[為您的 WorkSpaces 應用程式使用者啟用應用程式設定持續性](app-settings-persistence.md)。
   + 如果應用程式設定持續性未啟用，但 Windows 使用者已登入。

1. 您的工作階段指令碼會開始。如果已針對使用者啟用持久性儲存，則儲存連接器掛載也會開始。如需持久性儲存的相關資訊，請參閱[為您的 WorkSpaces 應用程式使用者啟用和管理持久性儲存](persistent-storage.md)。
**注意**  
儲存連接器掛載並不需要完成，串流工作階段也會開始。如果工作階段指令碼比儲存連接器掛載更早完成，串流工作階段會開始。  
如需有關監控儲存連接器掛載狀態的資訊，請參閱[使用儲存連接器搭配工作階段指令碼](use-storage-connectors-with-session-scripts.md)。

1. 您的工作階段指令碼完成或逾時。

1. 使用者的串流工作階段會開始。

1. 使用者選擇的應用程式會啟動。

如需 WorkSpaces 應用程式動態應用程式架構的相關資訊，請參閱 [使用 WorkSpaces 應用程式動態應用程式架構來建置動態應用程式提供者](build-dynamic-app-provider.md)。

當您在串流工作階段開始之前執行指令碼並啟用 WorkSpaces 應用程式動態應用程式架構時，會發生下列程序：

![\[WorkSpaces Applications workflow from user login to application launch, including SAML authentication and session scripts.\]](http://docs.aws.amazon.com/zh_tw/appstream2/latest/developerguide/images/session-scripts-with-DAF-domain-joined2.png)


1. 您的使用者會造訪您組織的 SAML 2.0 應用程式入口網站，並選擇 WorkSpaces 應用程式堆疊。

1. 它們連接到加入網域的 WorkSpaces 應用程式機群執行個體。

1. 如果已針對使用者啟用應用程式設定持續性，則會下載並掛載應用程式設定 VHD 檔案，其中存放使用者的自訂項目和 Windows 設定。

1. 發生 Windows 使用者登入。

1. 應用程式目錄會顯示在 WorkSpaces 應用程式入口網站中，您的使用者選擇要啟動的應用程式。

1. 您的工作階段指令碼會開始。如果已針對使用者啟用持久性儲存，則儲存連接器掛載也會開始。
**注意**  
儲存連接器掛載並不需要完成，串流工作階段也會開始。如果工作階段指令碼比儲存連接器掛載更早完成，串流工作階段會開始。  
如需有關監控儲存連接器掛載狀態的資訊，請參閱[使用儲存連接器搭配工作階段指令碼](use-storage-connectors-with-session-scripts.md)。

1. 您的工作階段指令碼完成或逾時。

1. 使用者的串流工作階段會開始。

1. 使用者選擇的應用程式會啟動。