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

# `pcluster dcv`


與在前端節點上執行的 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 版。

## 具名引數


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

## 子命令


### `pcluster dcv connect`


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

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

#### 定位引數


***cluster\$1name***  
指定要連接的叢集名稱。

#### 具名引數


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

**-k *SSH\$1KEY\$1PATH*, --key-path *SSH\$1KEY\$1PATH***  
用於連線的 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)