

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Interage com o servidor Amazon DCV em execução no nó principal.

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

**`pcluster dcv {{command}}`**  
Possíveis opções: [`connect`](#pcluster-dcv-connect)

**nota**  
Alterações no suporte do sistema operacional para o `pcluster dcv` comando em diferentes AWS ParallelCluster versões:  
O suporte para o comando `pcluster dcv` no `centos8` foi adicionado ao AWS ParallelCluster versão 2.10.0.
Support para o `pcluster dcv` comando em instâncias AWS baseadas em Graviton foi adicionado na AWS ParallelCluster versão 2.9.0.
O suporte para o comando `pcluster dcv` no `ubuntu1804` foi adicionado ao AWS ParallelCluster versão 2.6.0.
O suporte para o comando `pcluster dcv` no `centos7` foi adicionado ao AWS ParallelCluster versão 2.5.0.

## Argumentos nomeados
<a name="pcluster.dcv.namedarg"></a>

**-h, --help**  
Mostra o texto de ajuda para `pcluster dcv`.

## Subcomandos
<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}}
```

**Importante**  
O URL expira 30 segundos após ser emitido. Se a conexão não for estabelecida antes de o URL expirar, execute o `pcluster dcv connect` novamente para gerar um novo URL.

#### Argumentos posicionais
<a name="pcluster.dcv.connect.arg"></a>

**{{cluster\_name}}**  
Especifica o nome do cluster ao qual conectar-se.

#### Argumentos nomeados
<a name="pcluster.dcv.connect.namedarg"></a>

**-h, --help**  
Mostra o texto de ajuda para `pcluster dcv connect`.

**-k {{SSH\_KEY\_PATH}}, --key-path {{SSH\_KEY\_PATH}}**  
Caminho da chave SSH a ser usada para a conexão.  
A chave deve ser aquela especificada no momento da criação do cluster no parâmetro de configuração [`key_name`](cluster-definition.md#key-name). Este argumento é opcional, mas, se não for especificado, a chave deverá estar disponível por padrão para o cliente SSH. Por exemplo, adicione-o ao `ssh-agent` com `ssh-add`.

**-r {{REGION}}, --region** {{REGION}}  
Especifica o a Região da AWS ser usado. O padrão é o Região da AWS especificado usando o [`pcluster configure`](pcluster.configure.md) comando.

**-s, --show-url**  
Exibe um URL único para conectar-se à sessão do Amazon DCV. O navegador padrão não é aberto quando essa opção é especificada.  
Support para o `--show-url` argumento foi adicionado na AWS ParallelCluster versão 2.5.1.

**Exemplo usando a AWS ParallelCluster versão 2.11.7:**

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

Abre o navegador padrão para se conectar à sessão do Amazon DCV em execução no nó principal.

Uma nova sessão do Amazon DCV será criada se uma ainda não tiver sido iniciada.

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