本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

与头节点上运行的 Amazon DCV 服务器进行交互。

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

**`pcluster dcv command`**  
可能的选项：[`connect`](#pcluster-dcv-connect)

**注意**  
操作系统支持在不同 AWS ParallelCluster 版本中对该`pcluster dcv`命令进行更改：  
在 AWS ParallelCluster 版本 2.10.0 中增加了对 `centos8` 上 `pcluster dcv` 命令的支持。
2.9.0 版本中增加了对 AWS 基于 Graviton 的实例上的`pcluster dcv`命令的 AWS ParallelCluster 支持。
在 AWS ParallelCluster 版本 2.6.0 中增加了对 `ubuntu1804` 上 `pcluster dcv` 命令的支持。
在 AWS ParallelCluster 版本 2.5.0 中增加了对 `centos7` 上 `pcluster dcv` 命令的支持。

## 命名的参数
<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\$1name***  
指定要连接到的集群的名称。

#### 命名的参数
<a name="pcluster.dcv.connect.namedarg"></a>

**-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** *REGION*  
指定 AWS 区域 要使用的。默认为使用[`pcluster configure`](pcluster.configure.md)命令 AWS 区域 指定的值。

**-s, --show-url**  
显示用于连接到 Amazon DCV 会话的一次性 URL。指定此选项时，不打开默认浏览器。  
2.5.1 AWS ParallelCluster 版本中增加了对该`--show-url`参数的支持。

**使用 AWS ParallelCluster 版本 2.11.7 的示例：**

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

打开默认浏览器以连接到在头节点上运行的 Amazon DCV 会话。

如果尚未启动 Amazon DCV 会话，则会创建新会话。

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