Parâmetros SSHCommand

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura
  • Vários parâmetros estão disponíveis para a 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 tem 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 em Nome da fila do ECC o campo do formulário probe é o comando bruto que é executado no dispositivo.

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

    Este parâmetro só é válido 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
    porta Especifica a porta de destino à qual se conectar.
    • Número inteiro (porta)
    • Valor padrão: 22
    depurar Especifica se 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.
    . ServiceNow O cliente SSH 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 ServiceNow Cliente SSH:
      • 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 para registrar em log as 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.
    . ServiceNow O cliente SSH está desabilitado, este parâmetro habilita ou desabilita as informações de depuração SSH no arquivo de log:
    • Tipo: verdadeiro | falso
    • Valor padrão: falso
    debug_ssh Especifica se o cliente SSH legado grava informações de depuração no agent/logs/agent.log arquivo de log.
    Nota:
    Este arquivo de log pode crescer rapidamente e deve ser desabilitado quando não for necessário.
    . ServiceNow O cliente SSH não usa este parâmetro.
    • Tipo: verdadeiro | falso
    • Valor padrão: falso
    timeout Define o tempo limite de conexão do soquete para o cliente SSH legado.
    . ServiceNow O cliente 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.
    . ServiceNow O cliente SSH aceita os seguintes prefixos na frente 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.
    • Anexar: 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
    keyboard_interactive Determina se o modo de login SSH keyboard_interactive deve ser imposto.
    • Tipo: verdadeiro | falso
    • Valor padrão: falso
    must_sudo Determina se os comandos SSH são executados por sudo.
    Nota:
    o parâmetro de probe must_sudo afeta todos os padrões. Em hosts Unix ou Linux, a execução de padrão pode executar muitos comandos diferentes, alguns não devem ter sudo anexado.
    • Tipo: verdadeiro | falso
    • Valor padrão: falso
    run_in_terminal Determina se os comandos SSH são executados em um terminal SSH.
    • Tipo: verdadeiro | falso
    • Valor padrão:
      • ServiceNow Cliente SSH: Falso
      • Cliente SSH legado: Verdadeiro
    set_path Determina se a probe tem permissão para alterar a variável DE CAMINHO 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 .
    • Tipo: verdadeiro | falso
    • Valor padrão: verdadeiro
    rm_override Substitui o comando de remoção padrão (/bin/rm -f) com o valor fornecido.
    • Tipo: cadeia de caracteres
    • Valor-padrão: nenhum
    use_snc_ssh Habilita ServiceNow Cliente SSH. . ServiceNow O cliente SSH está ativo por padrão em novas instâncias. Habilitando o. ServiceNow O cliente SSH desabilita o cliente SSH legado.
    • Tipo: verdadeiro | falso
    • Valor padrão: verdadeiro
    command_timeout_ms Número de milissegundos que um comando SSH tem permissão para executar antes do tempo limite (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 do MID Server mid.ssh.command_timeout_ms.
    channel_timeout_ms Especifica a quantidade de tempo, em milissegundos, que um MID Server aguarda 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)
    preserve_sudo_environment 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 oferecer suporte ao -E comutador.
    • Tipo: verdadeiro | falso
    • Valor padrão: falso
    credentials_debug

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