Paramètres SSHCommand

Rversion finale: Australia

Mis à jour 12 mars 2026

5 minutes de lecture

Plusieurs paramètres sont disponibles pour la sonde SSHCommand.

Pour plus d’informations sur la configuration des paramètres de sonde, reportez-vous à la section Définir les paramètres de sonde.

Tableau 1. Table des paramètres
Paramètre	Description
allow_unsupported_shells	Permet à un concepteur de sonde de tenter d’exécuter une commande sur un appareil dont l’interpréteur de commandes n’est pas pris en charge. Sans shell, les éléments suivants sont vrais : Aucune information de chemin ne peut être fournie. Aucun script ne peut fonctionner, car il n’est pas possible de gérer les paramètres de script. Le texte spécifié dans le champ Nom de file d’attente ECC du formulaire de sonde est la commande brute exécutée sur l’appareil. Par exemple, vous pouvez concevoir une sonde pour afficher la version d’un commutateur Cisco exécutant NX-OS. La commande que le commutateur comprend est `afficher la version`. Pour ce faire, placez la commande `show version` dans le champ Nom de file d’attente ECC et ajoutez le nom du paramètre `allow_unsupported_shells` avec la valeur true. Ce paramètre est efficace uniquement pour `sncssh`. Il n’est pas pris en charge avec j2ssh. Les shells actuellement pris en charge sont sh, bash, ksh, csh et tcsh. Type : chaîne, vrai ou faux Valeur par défaut : faux
source	[Obligatoire] Spécifie l’hôte initial auquel se connecter. Type : chaîne (URL) Valeur par défaut : aucune
port	Spécifie le port cible auquel se connecter. Type : nombre entier (port) Valeur par défaut : 22
déboguer	Indique s’il faut écrire les informations de débogage SSH dans le fichier journal. L’utilisation du paramètre varie selon que le ServiceNow client SSH est activé ou non. Lorsque le ServiceNow client SSH est activé, ce paramètre fonctionne comme suit : Type : chaîne Valeur par défaut : faux Les valeurs de chaîne suivantes sont valides pour le ServiceNow client SSH : vrai : active les informations de débogage SSH dans le fichier journal. faux : désactive les informations de débogage SSH dans le fichier journal. <Adresses IP> : spécifie les plages IP pour activer les informations de débogage SSH dans le fichier journal. Vous pouvez saisir des adresses IP dans les formats suivants : Plage IP définie par une barre oblique et le nombre de bits dans le sous-réseau. Par exemple, la chaîne 10.10.10.0/24 analyse 24 bits d’adresses IP de 10.10.10.0 à 10.10.10.254. Plage IP définie par un tiret. Par exemple, la chaîne 10.10.11.0-10.10.11.165 analyse les adresses IP de 10.10.11.0 à 10.10.11.165. Une liste séparée par des virgules d’adresses IP spécifiques. Par exemple, la chaîne 10.10.11.200,10.10.11.235 analyse les adresses IP 10.10.11.200 et 10.10.11.235. différé : spécifie de consigner les informations de débogage SSH en mémoire sauf erreur ou avertissement. Si une erreur ou un avertissement se produit, la plateforme publie les informations de débogage dans le fichier journal. Cela garantit que seule la partie du fichier journal relative à l’erreur ou à l’avertissement est enregistrée. Si aucune erreur ou aucun avertissement n’est détecté, la plateforme supprime les données de journal inutilisées de la mémoire à la fermeture de la session. Chaque session stocke jusqu’à 1 000 messages de journal. Si la session dépasse 1 000 messages du journal, le journal différé ignore le message du journal le plus ancien pour faire de la place au message du journal le plus récent. Lorsque le ServiceNow client SSH est désactivé, ce paramètre active ou désactive les informations de débogage SSH dans le fichier journal : Type : true \| false Valeur par défaut : faux
debug_ssh	Spécifie si le client SSH hérité écrit les informations de débogage dans le fichier journal `agent/journaux/agent.log` . Remarque : Ce fichier journal peut évoluer rapidement et doit être désactivé lorsqu’il n’est pas nécessaire. Le ServiceNow client SSH n’utilise pas ce paramètre. Type : true \| false Valeur par défaut : faux
timeout	Définit le délai de connexion du socket pour le client SSH hérité. Le ServiceNow client SSH n’utilise pas ce paramètre. Type : nombre entier (millisecondes) Valeur par défaut : 60 000
path_override	Spécifie comment modifier les chemins d’accès par défaut définis avant d’exécuter une commande. Saisissez un ou plusieurs chemins d’accès de remplacement délimités par deux points (:). Le chemin par défaut est /usr/sbin : /usr/bin : /bin : /sbin. Le ServiceNow client SSH accepte les préfixes suivants devant la valeur path_overide : append : ajoute le chemin d’accès de remplacement à la fin du chemin d’accès de l’hôte. C’est le comportement par défaut. remplacer : remplace le chemin d’accès de l’hôte par la valeur path_overide. prepend : ajoute le chemin d’accès de remplacement à l’avant du chemin de l’hôte. Type : chaîne (une liste de répertoires séparés par deux-points) Valeur par défaut : aucune
keyboard_interactive	Détermine s’il convient d’appliquer keyboard_interactive mode de connexion SSH. Type : true \| false Valeur par défaut : faux
must_sudo	Détermine si les commandes SSH s’exécutent via sudo. Remarque : must_sudo paramètre de sonde affecte tous les schémas. Sur les hôtes Unix ou Linux, l’exécution du modèle peut exécuter de nombreuses commandes différentes, certaines ne doivent pas avoir sudo ajouté. Type : true \| false Valeur par défaut : faux
run_in_terminal	Détermine si les commandes SSH s’exécutent sur un terminal SSH. Type : true \| false Valeur par défaut : ServiceNow Client SSH : faux Client SSH hérité : vrai
set_path	Détermine si la sonde est autorisée à modifier la variable PATH de la session ou non. Par défaut, lors de la configuration de la session, la variable PATH est définie sur `/usr/sbin :/usr/bin :/bin :/sbin.` Type : true \| false Valeur par défaut : true
rm_override	Remplace la commande remove par défaut `(/bin/rm -f)` par la valeur fournie. Type : chaîne Valeur par défaut : aucune
use_snc_ssh	Active le ServiceNow client SSH. Le ServiceNow client SSH est actif par défaut sur les nouvelles instances. L’activation du ServiceNow client SSH désactive le client SSH hérité. Type : true \| false Valeur par défaut : true
command_timeout_ms	Nombre de millisecondes pendant lesquelles une commande SSH est autorisée à s’exécuter avant l’expiration (la valeur par défaut est configurable par serveur MID). Le client SSH hérité n’utilise pas ce paramètre. Type : nombre entier Valeur par défaut : valeur du paramètre Serveur MID mid.ssh.command_timeout_ms.
channel_timeout_ms	Spécifie la durée, en millisecondes, pendant laquelle un serveur MID attend une activité pendant le traitement d’une commande SSH. Si le serveur MID ne détecte pas d’activité dans la fenêtre de délai spécifiée, ce paramètre arrête la commande. Type : nombre entier (millisecondes) Valeur par défaut : 300 000 (5 minutes)
preserve_sudo_environment	Indique s’il faut utiliser Sudo pour préserver l’environnement pour SSH. Ce paramètre n’est efficace que si l’environnement sudo sur l’hôte sondé prend en charge le commutateur `-E` . Type : true \| false Valeur par défaut : faux
credentials_debug	Affiche une section <credentials_debug> dans la file d’attente ECC, qui peut vous aider à résoudre les problèmes liés aux informations d’identification. Si vous définissez cette propriété sur true, les informations de dépannage des informations d’identification sont envoyées à la file d’attente ECC, même si les informations d’identification réussissent. Voir Dépannage des informations d’identification pour plus d’informations.