Executar comando SSH

2025-03-19

A atividade Executar comando SSH abre uma conexão SSH com um servidor remoto e executa comandos shell nesse servidor. Use a atividade Executar comando SSH para executar aplicativos de backup ou um script em lote que executa um conjunto de comandos complexos em um computador que não seja Windows. A atividade Run SSH Command pode executar qualquer comando em um Secure Shell.

A atividade Executar Comando SSH é baseado no PuTTY beta .70. A implementação de SSH em "Run SSH Command" tem certas limitações:

A atividade Executar comando SSH não funciona em todos os servidores SSH-1 e SSH-2. Em geral, essa atividade funciona com a maioria dos servidores SSH, mas não funciona para todas as implementações de servidor SSH.
Você deve baixar e usar a ferramenta de geração de chaves PuTTy para criar chaves para a atividade Run SSH Command. A ferramenta de geração de chaves está disponível em Download PuTTY - um cliente SSH e telnet gratuito para Windows.
A atividade Run SSH Command suporta SSH-1. A Microsoft não recomenda o uso de SSH-1. Se quiser impedir que a atividade Executar Comando SSH use SSH-1, use um arquivo de chave que contenha chaves que não suportam SSH-1. Não use um par de nome de usuário e senha; Use um arquivo de chave.
A propriedade Aceitar alteração de chave de host não é uma configuração recomendada. Essa propriedade só deve ser usada para estabelecer a conexão inicial com um computador quando a chave é armazenada no servidor runbook. Os runbooks que contêm a atividade Executar Comando SSH devem ser configurados com Aceitar Alteração de Chave de Host desabilitada. Quando você usa essa propriedade, ela desabilita a validação da identidade do servidor SSH e representa um risco de segurança.
Você deve rever a lista de cifras criptográficas suportadas pelo PuTTY, que é encontrada em https://the.earth.li/~sgtatham/putty/0.70/htmldoc/Chapter4.html#config-ssh-encryption.
PuTTY beta .61 usa um gerador de números pseudoaleatórios adequado para a maioria dos fins criptográficos. Não é recomendado para a geração de chaves criptográficas de longo prazo.

Para obter mais informações sobre PuTTY, vá para Download PuTTY - um cliente SSH e telnet gratuito para Windows.

Configurar a Atividade de Executar Comando SSH

Antes de configurar a atividade Executar comando SSH, você precisa determinar o seguinte:

Informações de conexão para o computador que hospeda o servidor SSH ao qual você deseja se conectar.
Comandos que você deseja executar.
Se você precisa de um arquivo de chave para entrar no servidor antes de poder executar comandos; isso depende do seu servidor SSH.

Use as informações a seguir para configurar a atividade Executar comando SSH.

Detalhes

Configurações	Instruções de configuração
Computador	Digite o nome do computador ou endereço IP onde o servidor SSH está sendo executado. Pode também usar o botão de reticências (...) para procurar pelo computador.
Porto	Digite o número da porta que você precisa usar para se conectar ao servidor SSH.
Executar comando	Selecione essa opção e digite o comando que deseja executar no servidor SSH após a conexão ter sido estabelecida.
Conjunto de Comandos Ficheiro	Selecione essa opção e especifique um arquivo que contenha um conjunto de comandos que serão executados no servidor SSH quando a conexão for estabelecida. O arquivo de conjunto de comandos deve usar a linguagem de script do shell nativo no servidor SSH.
Aceitar alteração de chave de host	Selecione esta opção para aceitar alterações de chave de host quando elas ocorrerem. Nota de segurança: É recomendável que você não use essa configuração porque ela pode fazer com que um runbook aceite qualquer alteração em um servidor, incluindo qualquer alteração que seja para fins mal-intencionados. Ao selecionar essa opção, você está instruindo a atividade a se conectar a qualquer servidor, independentemente da chave do host. Utilize esta opção apenas para fins de teste.
Tempo limite de conexão	Especifique o tempo, em segundos, que a atividade Executar comando SSH aguardará até à conclusão do comando SSH. Configure um valor de `0` (zero) ou deixe a caixa em branco para aguardar indefinidamente. Após o período de tempo limite, a atividade Executar Comando SSH expira e retorna um aviso. O comando que você executou pode continuar em execução, independentemente de a atividade Executar Comando SSH expirar.

Avançado

Configurações	Instruções de configuração
Nome de utilizador	Digite o nome de usuário que você precisa para entrar no servidor SSH.
Palavra-passe	Selecione essa opção e digite a senha associada ao Nome de usuário especificado.
Arquivo de Chave	Selecione esta opção para especificar um arquivo de chave a ser usado. Você deve usar o gerador de arquivos de chave PuTTY para criar um arquivo de chave. Você pode baixar esta ferramenta de Download PuTTY - um cliente SSH e telnet gratuito para Windows.
Frase de segurança	Digite a senha associada ao arquivo de chave que você especificou.

Dados publicados

A tabela a seguir lista os itens de dados publicados.

Número	Descrição
Comando	O comando executado no servidor SSH. Esses dados não estão disponíveis quando a opção Command set File é selecionada.
Arquivo do conjunto de comandos	O arquivo de conjunto de comandos que foi usado para executar comandos no servidor SSH. Esta opção não está disponível quando a opção Executar Comando está selecionada.
Nome do computador	O nome ou endereço IP do servidor SSH.
Resultado da Execução	O texto que foi publicado como saída dos comandos que foram executados no servidor SSH.
Código de saída	O código de saída publicado pelo comando. Ao usar um arquivo de conjunto de comandos, este será o código de saída do último comando no arquivo.
Caminho do arquivo chave	O caminho do arquivo de chave que foi usado para autenticar com o servidor SSH.
Porto	A porta usada para se conectar ao servidor SSH.
Nome de utilizador	O nome de usuário usado para entrar no servidor SSH.

Próximos passos

Consulte o artigo sobre como obter as variáveis SNMP .