Parâmetros SSHCommand

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura
  • Vários parâmetros estão disponíveis para o probe SSHCommand.

    Para obter instruções sobre como configurar parâmetros de probe, consulte Definir parâmetros de probe.

    Tabela 1. Tabela de parâmetros
    Parâmetro Descrição
    allow_unsupported_shells Permite que um designer de probe tente executar um comando em um dispositivo que não tenha um shell compatível. Sem shell, o seguinte é verdadeiro:
    • Nenhuma informação de caminho pode ser fornecida.
    • Nenhum script pode funcionar, porque não há capacidade de lidar com parâmetros de script.
    • O texto especificado no campo de nome da fila do ECC do formulário de probe é o comando bruto executado no dispositivo.

    Por exemplo, você pode projetar uma probe para exibir a versão de um comutador Cisco que executa o SX-OS. O comando que o comutador entende é show version. Para fazer isso, coloque o comando show version no campo de nome da fila do ECC e adicione o nome do parâmetro allow_unsupported_shells com um valor verdadeiro.

    Este parâmetro só é eficaz para sncssh. Não é compatível com j2ssh. Os shells compatíveis atualmente são sh, bash, ksh, csh e tcsh.

    • Tipo: cadeia de caracteres, verdadeiro ou falso
    • Valor padrão: falso
    origem [Obrigatório] Especifica o host inicial ao qual se conectar.
    • Tipo: cadeia de caracteres (URL)
    • Valor padrão: Nenhum
    port Especifica a porta de destino à qual se conectar.
    • Tipo: inteiro (porta)
    • Valor padrão: 22
    depurar Especifica se as informações de depuração SSH devem ser gravadas no arquivo de log. O uso do parâmetro depende se o cliente SSH ServiceNow está habilitado.
    Quando o cliente SSH ServiceNow está habilitado, este parâmetro funciona da seguinte forma:
    • Tipo: cadeia de caracteres
    • Valor padrão: falso
      Os seguintes valores de cadeia de caracteres são válidos para o cliente SSH ServiceNow :
      • verdadeiro: Habilita as informações de depuração SSH no arquivo de log.
      • falso: Desabilita as informações de depuração do SSH no arquivo de log.
      • <IP Addresses>: especifica quais intervalos de IP habilitar informações de depuração SSH no arquivo de log. Você pode inserir endereços IP nos seguintes formatos:
        • Um intervalo de IPs definido por uma barra e o número de bits na sub-rede. Por exemplo, a cadeia de caracteres 10.10.10.0/24 verifica 24 bits de endereços IP de 10.10.10.0 a 10.10.10.254.
        • Um intervalo de IPs definido por um hífen. Por exemplo, a cadeia de caracteres 10.10.11.0-10.10.11.165 verifica os endereços IP de 10.10.11.0 a 10.10.11.165.
        • Uma lista separada por vírgulas de endereços IP específicos. Por exemplo, a cadeia de caracteres 10.10.11.200,10.10.11.235 verifica os endereços IP de 10.10.11.200 e 10.10.11.235.
      • adiado: especifica o registro em log das informações de depuração SSH na memória, a menos que ocorra um erro ou aviso. Se ocorrer um erro ou aviso, a plataforma publicará as informações de depuração no arquivo de log. Isso garante que somente a parte do arquivo de log relativa ao erro ou aviso seja registrada. Se nenhum erro ou aviso for detectado, a plataforma excluirá os dados de log não utilizados da memória quando a sessão for fechada. Cada sessão armazena até 1000 mensagens de log. Se a sessão exceder 1000 mensagens de log, o log adiado descartará a mensagem de log mais antiga para abrir espaço para a mensagem de log mais recente.
    Quando o cliente ServiceNow SSH está desabilitado, este parâmetro habilita ou desabilita as informações de depuração SSH no arquivo de log:
    • Digite: verdadeiro | falso
    • Valor padrão: falso
    debug_ssh Especifica se o cliente SSH legado grava informações de depuração no arquivo de log agent/logs/agent.log.
    Nota:
    Este arquivo de log pode crescer rapidamente e deve ser desabilitado quando não for necessário.
    O cliente ServiceNow SSH não usa este parâmetro.
    • Digite: verdadeiro | falso
    • Valor padrão: falso
    tempo limite Define o tempo limite de conexão do soquete para o cliente SSH legado.
    O cliente ServiceNow SSH não usa este parâmetro.
    • Tipo: inteiro (milissegundos)
    • Valor padrão: 60.000
    path_override Especifica como mudar os caminhos padrão definidos antes de executar um comando. Digite um ou mais caminhos de substituição delimitados por dois pontos (:). O caminho padrão é /usr/sbin: /usr/bin: /bin: /sbin.
    O cliente SSH ServiceNow aceita os seguintes prefixos antes do valor path_overide:
    • anexar: anexa o caminho de substituição ao final do caminho do host. Esse é o comportamento padrão.
    • substituir: substitui o caminho do host pelo valor path_overide.
    • prepend: anexa o caminho de substituição à frente do caminho do host.
    • Tipo: cadeia de caracteres (uma lista de diretórios separada por dois pontos)
    • Valor padrão: Nenhum
    teclado_interativo Determina se o modo de login SSH de teclado_interativo deve ser imposto.
    • Digite: verdadeiro | falso
    • Valor padrão: falso
    must_sudo Determina se os comandos SSH são executados por meio de sudo.
    Nota:
    O parâmetro de probe must_sudo afeta todos os padrões. Em hosts Unix ou Linux, a execução do padrão pode executar muitos comandos diferentes, alguns não devem ter sudo anexado.
    • Digite: verdadeiro | falso
    • Valor padrão: falso
    executar_no_terminal Determina se os comandos SSH são executados em um terminal SSH.
    • Digite: verdadeiro | falso
    • Valor padrão:
      • ServiceNow Cliente SSH: falso
      • Cliente SSH legado: verdadeiro
    set_path Determina se o probe tem permissão para alterar a variável PATH da sessão ou não. Por padrão, durante a configuração da sessão, a variável PATH é definida como /usr/sbin:/usr/bin:/bin:/sbin.
    • Digite: verdadeiro | falso
    • Valor padrão: verdadeiro
    rm_override Substitui o comando de remoção padrão (/bin/rm -f) pelo valor fornecido.
    • Tipo: cadeia de caracteres
    • Valor-padrão: nenhum
    usar_snc_ssh Habilita o ServiceNow cliente SSH. O cliente ServiceNow SSH está ativo por padrão em novas instâncias. Habilitar o cliente SSH ServiceNow desabilita o cliente SSH legado.
    • Digite: verdadeiro | falso
    • Valor padrão: verdadeiro
    comando_timeout_ms Número de milissegundos em que um comando SSH pode ser executado antes que o tempo limite se esgote (o padrão é configurável por MID Server).
    O cliente SSH legado não usa este parâmetro.
    • Tipo: inteiro
    • Valor padrão: valor do parâmetro mid.ssh.command_timeout_ms do MID Server.
    canal_tempo_limite_ms Especifica a quantidade de tempo, em milissegundos, que um MID Server espera pela atividade durante o processamento de um comando SSH. Se o MID Server não detectar atividade na janela de tempo limite especificada, este parâmetro eliminará o comando.
    • Tipo: inteiro (milissegundos)
    • Valor padrão: 300000 (5 minutos)
    preservar_sudo_ambiente Especifica se o sudo deve ser usado para preservar o ambiente de SSH. Este parâmetro só será eficaz se o ambiente sudo no host que está sendo testado for compatível com a opção -E.
    • Digite: verdadeiro | falso
    • Valor padrão: falso
    credenciais_depuração

    Exibe um<credentials_debug> seção na fila do ECC, que pode ajudá-lo a solucionar problemas de credenciais. Se você definir esta propriedade como verdadeira, as informações de solução de problemas de credencial serão enviadas para a fila do ECC, mesmo se as credenciais forem bem-sucedidas. Consulte Solução de problemas de credenciais para obter mais informações.