本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 啟動 Amazon DCV 工作階段
當您使用預設值[安裝 Windows Amazon DCV 伺服器](setting-up-installing-wininstall.md)時，[主控台工作階段](managing-sessions-intro.md#managing-sessions-intro-console)會在安裝伺服器後自動建立並啟用。預設主控台工作階段由 `Administrator` 所擁有，且預設工作階段 ID 為 `console`。您可以使用此工作階段，也可以[將其關閉](managing-sessions-lifecycle-stop.md)並建立新的工作階段。
如果您在安裝 Amazon DCV 伺服器時選擇不建立自動主控台工作階段，則必須手動建立一個。安裝 Amazon DCV 伺服器之後，您可以隨時啟用或停用[自動建立主控台工作階段](#managing-sessions-start-auto)。
**注意**
Linux 和 macOS Amazon DCV 伺服器在安裝後不會取得預設主控台工作階段。
假設您在內部部署或其他雲端伺服器上使用浮動授權，並超過授權支援的並行工作階段數量上限。您可能會收到`no licenses`錯誤。如果您收到此錯誤，請停止未使用的工作階段，以釋放授權並重試。
Amazon DCV 伺服器必須執行才能啟動工作階段。如需詳細資訊，請參閱[啟動 Amazon DCV 伺服器](manage-start.md)。
**Topics**
+ [手動啟動主控台和虛擬工作階段](#managing-sessions-start-manual)
+ [啟用自動主控台工作階段](#managing-sessions-start-auto)
## 手動啟動主控台和虛擬工作階段
您可以隨時啟動 Amazon DCV 工作階段。您一次只能執行一個主控台工作階段。如果您使用的是 Linux Amazon DCV 伺服器，則可以同時執行多個虛擬工作階段。
最好在建立工作階段`dcv list-sessions`之前執行，尤其是使用 Windows Amazon DCV 伺服器時。
若要在 Windows、Linux 或 macOS Amazon DCV 伺服器上建立主控台或虛擬工作階段，請使用 `dcv create-session`命令。
**Topics**
+ [語法](#managing-sessions-start-manual-syntax)
+ [選項](#managing-sessions-start-manual-options)
+ [範例](#managing-sessions-start-manual-examples)
### 語法
啟動工作階段的 命令最小語法為：
```
dcv create-session session_ID
```
所有選項的完整語法為：
```
dcv create-session \
--type console|virtual \
--name session_name \
--user username \
--owner owner_name \
--permissions-file /path_to/permissions_file \
--storage-root /path_to/storage_directory \
--gl on|off \
--max-concurrent-clients number_of_clients \
--init /path_to/init_script \
session_ID
```
**注意**
`\` 符號 代表將命令分割成多行的語法。
您也可以使用 `dcv create-session --help`顯示語法的快速參考。
### 選項
下列選項可以搭配 `dcv create-session` 命令使用：
**`--type`**
此選項僅支援 Linux Amazon DCV 伺服器。此選項指定要建立的工作階段類型，可以是 `console` 或 `virtual`。
類型：字串
允許的值：`console` \$1 `virtual`
必要：否
**`--name`**
指定工作階段的名稱。工作階段名稱可以是任何字串，最多 256 個字元。如果字串超過 256 個字元，命令會失敗。工作階段名稱在執行中的工作階段之間不需要是唯一的。
您可以隨時使用 `dcv set-name`命令變更工作階段的名稱。如需詳細資訊，請參閱[管理工作階段名稱](managing-session-name.md)。
類型：字串
必要：是
**`--user`**
此選項僅支援 Linux Amazon DCV 工作階段上的虛擬工作階段。此值即是要用來建立工作階段的使用者。只有根使用者才可以模擬其他使用者。
類型：字串
必要：否
**`--owner`**
指定工作階段擁有者。如果省略，則預設為目前登入的使用者。
類型：字串
必要：否
**`--permissions-file`**
指定自訂許可檔案的路徑。如果省略，則預設為伺服器預設值。
類型：字串
必要：否
**`--storage-root`**
指定要用於儲存工作階段之資料夾的路徑。
您可以使用 `%home%` 來指定目前登入之使用者的主目錄。例如，若為 Windows 伺服器，下列選項將工作階段儲存區的目錄設為 `c:\Users\username\storage\`，若為 Linux 伺服器，則設為 `$HOME/storage/`。
```
--storage-root %home%/storage/
```
如果指定的子目錄不存在，則會停用工作階段儲存。
類型：字串
必要：否
**`--gl`**
此選項僅支援 Linux Amazon DCV 工作階段上的虛擬工作階段。這會覆寫預設 `dcv-gl` 狀態，可以是 `on` 或 `off`。
類型：字串
允許的值：`on` \$1 `off`
必要：否
**`--max-concurrent-clients`**
指定允許連線至工作階段的 Amazon DCV 用戶端數量上限。如果省略，則預設為無限制的連接數。
類型：整數
必要：否
**`--init`**
此選項僅支援 Linux Amazon DCV 伺服器上的虛擬工作階段。這會指定自訂 `init` 指令碼的路徑。此指令碼可用來啟動特定桌面環境，以及自動在工作階段開始時啟動特定應用程式。指令碼必須可執行。如果省略，則預設為啟動預設桌面環境的指令碼。
類型：字串
必要：否
**`session ID`**
在命令結尾提供工作階段的 ID。
類型：字串
必要：是
### 範例
**範例 1 - 主控台工作階段**
下列命令會建立 擁有的主控台工作階段，`dcv-user`其唯一工作階段 ID 為 `my-session`，工作階段名稱為 `my graphics session`。它也會指定名為 的許可檔案`perm-file.txt`。
+ Windows Amazon DCV 伺服器
```
C:\> dcv create-session^
--owner dcv-user^
--name "my graphics session"^
--permissions-file perm-file.txt^
my-session
```
+ Linux Amazon DCV 伺服器
```
$ sudo dcv create-session \
--type=console \
--owner dcv-user \
--name "my graphics session" \
--permissions-file perm-file.txt \
my-session
```
**範例 2 - 虛擬工作階段 （僅限 Linux Amazon DCV 伺服器）**
下列命令會使用根使用者建立虛擬工作階段，以模擬預期的工作階段擁有者 `dcv-user`。即使工作階段是由根使用者建立，`dcv-user`仍由 擁有
```
$ sudo dcv create-session \
--owner dcv-user \
--user dcv-user \
my-session
```
**範例 3 - 虛擬工作階段 （僅限 Linux Amazon DCV 伺服器）**
下列命令會建立建立使用者擁有的虛擬工作階段：
```
$ dcv create-session my-session
```
## 啟用自動主控台工作階段
啟用自動主控台工作階段可確保每次 Amazon DCV 伺服器啟動時，都會自動建立主控台工作階段。自動主控台工作階段是由`owner`組態參數指定的 Amazon DCV 使用者所擁有。其工作階段 ID 一律為 `console`。
其他會影響自動主控台工作階段的參數是 `max-concurrent-clients`、`permissions-file` 和 `storage-root`。如需這些參數的相關資訊，請參閱 [`session-management/automatic-console-session` 參數](config-param-ref.md#session_management_automatic_console_session)。
**注意**
Amazon DCV 不支援自動虛擬工作階段。
------
#### [ Windows Amazon DCV server ]
**在 Windows Amazon DCV 伺服器上啟用自動主控台工作階段**
1. 開啟 Windows 登錄編輯程式。
1. 導覽至 **HKEY\$1USERS\$1S-1-5-18\$1Software\$1GSettings\$1com\$1nicesoftware\$1dcv\$1session-management** 金鑰。
1. 建立 `create-session` 參數：
1. 在導覽窗格中，開啟**工作階段管理**金鑰的內容 （按一下滑鼠右鍵） 選單，然後選擇**新增**、**DWORD (32 位元） 值**。
1. 在**名稱**中，輸入 `create-session`，然後按 **Enter**。
1. 開啟 **create-session** 參數。在**數值資料**中，輸入 `1`，然後選擇**確定**。
1. 導覽至 **HKEY\$1USERS\$1S-1-5-18\$1Software\$1GSettings\$1com\$1nicesoftware\$1dcv\$1session-management/automatic-console-session** 金鑰。
1. 建立 `owner` 參數：
1. 在導覽窗格中，開啟**automatic-console-session**索引鍵的內容 （按一下滑鼠右鍵） 選單，然後選擇**新增**、**字串值**。
1. 在**名稱**中，輸入 `owner`，然後按 **Enter**。
1. 開啟 **owner** 參數。在**數值資料**中，輸入工作階段擁有者的名稱，並選擇**確定**。
1. 選擇 **OK (確定)** 並關閉 Windows 登錄編輯程式。
1. [停止](manage-stop.md)並[重新啟動](manage-start.md) Amazon DCV 伺服器。
------
#### [ Linux Amazon DCV server ]
**在 Linux Amazon DCV 伺服器上啟用自動主控台工作階段**
1. 導覽至 `/etc/dcv/`，然後使用您徧好的文字編輯器開啟 `dcv.conf`。
1. 使用下列格式將 `create-session` 和 `owner` 參數新增至 `[session-management/automatic-console-session]`：
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="session-owner"
```
1. 儲存並關閉檔案。
1. [停止](manage-stop.md)並[重新啟動](manage-start.md) Amazon DCV 伺服器。
------
#### [ macOS Amazon DCV server ]
**在 macOS Amazon DCV 伺服器上啟用自動主控台工作階段**
1. 導覽至 `/etc/dcv/`，然後使用您徧好的文字編輯器開啟 `dcv.conf`。
1. 使用下列格式將 `create-session` 和 `owner` 參數新增至 `[session-management/automatic-console-session]`：
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="session-owner"
```
1. 儲存並關閉檔案。
1. [停止](manage-stop.md)並[重新啟動](manage-start.md) Amazon DCV 伺服器。
------