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

# `pcluster dcv`
<a name="pcluster.dcv"></a>

與在前端節點上執行的 Amazon DCV 伺服器互動。

```
pcluster dcv [ -h ] ( connect )
```

**`pcluster dcv {{command}}`**  
可能的選擇如下：[`connect`](#pcluster-dcv-connect)

**注意**  
作業系統支援不同 AWS ParallelCluster 版本中`pcluster dcv`命令的變更：  
2.10.0 版中`centos8` AWS ParallelCluster 已新增 上的 `pcluster dcv`命令支援。
在 AWS 2.9.0 AWS ParallelCluster 版中新增了 Graviton 型執行個體的 `pcluster dcv`命令支援。
2.6.0 版中`ubuntu1804` AWS ParallelCluster 已新增 上的 `pcluster dcv`命令支援。
在 上的 `pcluster dcv`命令支援`centos7`已新增至 2.5. AWS ParallelCluster 0 版。

## 具名引數
<a name="pcluster.dcv.namedarg"></a>

**-h, --help**  
顯示 的說明文字`pcluster dcv`。

## 子命令
<a name="pcluster-dcv-subcommands"></a>

### `pcluster dcv connect`
<a name="pcluster-dcv-connect"></a>

```
pcluster dcv connect [ -h ] [ -k {{SSH_KEY_PATH}} ] [ -r {{REGION}} ] {{cluster_name}}
```

**重要**  
URL 會在發出後 30 秒過期。如果在 URL 過期之前未進行連線，請`pcluster dcv connect`再次執行 以產生新的 URL。

#### 定位引數
<a name="pcluster.dcv.connect.arg"></a>

**{{cluster\_name}}**  
指定要連接的叢集名稱。

#### 具名引數
<a name="pcluster.dcv.connect.namedarg"></a>

**-h, --help**  
顯示 的說明文字`pcluster dcv connect`。

**-k {{SSH\_KEY\_PATH}}, --key-path {{SSH\_KEY\_PATH}}**  
用於連線的 SSH 金鑰的金鑰路徑。  
金鑰必須在 [`key_name`](cluster-definition.md#key-name) 組態參數中叢集建立之時指定。此引數是選用的，但如果未指定，則 SSH 用戶端預設必須使用 金鑰。例如，利用 `ssh-add` 將其新增至 `ssh-agent`。

**-r {{REGION}}, --region** {{區域}}  
指定 AWS 區域 要使用的 。使用 [`pcluster configure`](pcluster.configure.md)命令預設為 AWS 區域 指定的 。

**-s, --show-url**  
顯示連線至 Amazon DCV 工作階段的一次性 URL。指定此選項時，預設瀏覽器不會開啟。  
2.5.1 AWS ParallelCluster 版中已新增對 `--show-url`引數的支援。

**使用 2.11.7 AWS ParallelCluster 版的範例：**

```
$ pcluster dcv connect -k {{~/.ssh/id_rsa}} {{mycluster}}
```

開啟預設瀏覽器以連線至在前端節點上執行的 Amazon DCV 工作階段。

如果尚未啟動 Amazon DCV 工作階段，則會建立新的工作階段。

 ![A screenshot of the DCV console.](http://docs.aws.amazon.com/zh_tw/parallelcluster/v2/ug/images/Dcv-image.png)