---
title: Comando
slug: aiops-documentacao-tecnica/comando
docTags:
createdAt: 2024-07-17T17:48:01.287Z
---
### Resumo
- Execute os comandos desejados.
## Paramêtros
| Paramêtros | Tipos | Escolhas Valor Padrão | Comentários |
| ---------------------- | --------------------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| argv | lista / elementos =
strings | | Transmita o comando como uma lista em vez de uma string. Use argv para evitar citar valores que, de outra forma, seriam interpretados incorretamente (por exemplo "nome do usuário"). Apenas a forma de string (forma livre) ou de lista (argv) pode ser fornecida, não ambas. Um ou outro deve ser fornecido. |
| chdir | caminho | | Mudar o diretório antes de executar o comando. |
| comando | corda | | O comando será executado. |
| cria | caminho | | Um nome ou arquivo de padrão glob. Se já existr um arquivo correspondente, está etapa não será realizada. |
| forma livre | corda | | O módulo de comando usa uma string de formato livre como um comando para ser executado. Não há nenhum paramêtro real denominado "formato livre".
|
| remove | caminho | | Um nonme de arquivo ou padrão glob. Se houver um arquivo correspondente, está etapa será realizada. |
| padrão | corda | | Defina o stdin do comando diretamente para o valor especificado. |
| stdin\_add\_nova\_lina | boleano | Escolhas:
-verdadeiro
-falso (padrão) | SE definido como verdadeiro, a estação atmosférica é uma nova linha aos dados stdin. |
| strip\_empty\_ends | boolean | Escolhas:
-verdadeiro
-falso (padrão) | Retire as linhas vazias do final de stdout/stderr no resultado. |
| warn | boolean | Escolhas:
-verdadeiro
-falso (padrão) | Habilite ou desabilite os avisos de tarefa. |
# Notas
- Se você deseja executar um comando por meio do shell (digamos que usamos \<,>,| e assim por diante) uma análise de metacaracteres do shell pode fazer com que comandos inesperados sejam executados se a cotação não for feita corretamente, portanto é mais seguro usar o módulo de comando quando possível.
- Crie, remova e chdir podem ser especifucados após o comando. Poe exemplo, se você deseja executar um comando, se um determinado arquivo não existir, use-o.
- O modo de verificação é suportado após passar cria ou remove. Se você estiver executando no mode de verificação, e qualquer um deles especificados, o módulo verifcará a existência do arquivo e relatará o status alterado correto. Se não for entregue, a tarefa será ignorada.
# Exemplos
\# Exemplo: Retornar motd para variável registrada
\- command: cat /etc/motd
register: mymotd
\# Exemplo: Execute o comando se /path/to/database não existir (sem a palavra-chave 'args').
\- command: /usr/bin/make\_database.sh db\_user db\_name creates=/path/to/database
\# 'args' é uma palavra-chave de tarefa, passada no mesmo nível que o módulo
\# Exemplo: Execute o comando se /path/to/database não existir (com a palavra-chave 'args').
\- command: /usr/bin/make\_database.sh db\_user db\_name
args:
creates: /path/to/database
\# 'cmd' é um parâmetro do módulo
\# Exemplo: Execute o comando se /path/to/database não existir (com o parâmetro 'cmd').
\- command:
cmd: /usr/bin/make\_database.sh db\_user db\_name
creates: /path/to/database
\# Exemplo: Altere o diretório de trabalho para somedir/ e,
\# execute o comando como db\_owner se /path/to/database não existir.
\- command: /usr/bin/make\_database.sh db\_user db\_name
become: yes
become\_user: db\_owner
args:
chdir: somedir/
creates: /path/to/database
\# 'argv' é um parâmetro, identado um nível do módulo
\# Exemplo: Use 'argv' para enviar um comando como uma lista - deixe o 'command' vazio
\- command:
argv:
\- /usr/bin/make\_database.sh
\- Username with whitespace
\- dbname with whitespace
\# Exemplo: Use com segurança a variável de modelo para executar o comando. Sempre use o filtro de cotação para evitar problemas de injeção.
\- command: cat \{\{ myfile|quote }}
register: myoutput
## Valores devolvidos
| **Chave** | **Tipo** | **Retornando **
**quando** | **Descrição** |
| ---------------- | ----------------------- | ------------------------------------ | ---------------------------------------- |
| comando | lista/ elementos=string | Sempre | O comando executado pela tarefa |
| delta | corda | Sempre | O tempo delta de execuação do comando |
| fim
começar | corda | Sempre | A hora de término de execução do comando |
| | corda | Sempre | A hora de início de execução do comando |
| | | | |
| | | | |