SSHCommand 매개변수

여러 매개변수를 SSHCommand 프로브에 사용할 수 있습니다.

프로브 매개변수 구성에 대한 지침은 프로브 매개변수 설정 문서를 참조하십시오.

표 1. 매개변수 테이블

매개변수	설명
allow_unsupported_shells	지원되는 셸이 없는 장치에서 프로브 디자이너가 명령 실행을 시도할 수 있도록 합니다. 셸이 없는 경우 다음이 적용됩니다. 경로 정보를 제공할 수 없습니다. 스크립트 매개변수를 처리할 수 있는 기능이 없기 때문에 스크립트가 작동하지 않습니다. 프로브 양식의 ECC 큐 이름 필드에 지정된 텍스트는 장치에서 실행되는 원시 명령입니다. 예를 들어, NX-O를 실행하는 CIsco 스위치의 버전을 표시하도록 프로브를 설계할 수 있습니다. 이 스위치에서 이해하는 명령은 show version입니다. 이를 위해서는 ECC 큐 이름 필드에 show version 명령을 입력하고 값이 true인 매개변수 이름 allow_unsupported_shell를 추가합니다. 이 매개변수는 sncssh에만 유효합니다. j2ssh에는 지원되지 않습니다. 현재 지원되는 셸은 sh, bash, ksh, csh 및 tcsh입니다. 유형: 문자열, true 또는 false 기본값: false
source	[필수] 연결할 초기 호스트를 지정합니다. 유형: 문자열(URL) 기본값: 없음
port	연결할 대상 포트를 지정합니다. 형식: 정수(포트) 기본값: 22
debug	SSH 디버그 정보를 로그 파일에 쓸지 여부를 지정합니다. 매개변수 사용은 ServiceNow SSH 클라이언트가 사용되는지 여부에 따라 달라집니다. ServiceNow SSH 클라이언트가 사용되면 이 매개변수는 다음과 같이 작동합니다. 유형: 문자열 기본값: false ServiceNow SSH 클라이언트에 대해 유효한 문자열 값은 다음과 같습니다. true: 로그 파일에서 SSH 디버그 정보를 사용하도록 설정합니다. false: 로그 파일에서 SSH 디버그 정보를 사용하지 않도록 설정합니다. <IP Addresses>: 로그 파일에서 SSH 디버그 정보를 사용할 IP 범위를 지정합니다. 다음 형식으로 IP 주소를 입력할 수 있습니다. 슬래시(/)로 정의된 IP 범위와 서브 네트워크의 비트 수입니다. 예를 들어, 문자열 10.10.10.0/24는 10.10.10.0 ~ 10.10.10.254의 24비트 IP 주소를 검사합니다. 대시로 정의된 IP 범위입니다. 예를 들어, 문자열 10.10.11.0-10.10.11.165는 10.10.11.0 ~ 10.10.11.165의 IP 주소를 검사합니다. 쉼표로 구분된 특정 IP 주소 목록입니다. 예를 들어, 문자열 10.10.11.200,10.10.11.235는 IP 주소10.10.11.200과 10.10.11.235를 검사합니다. 지연: 오류나 경고가 발생하지 않는 한 메모리에 SSH 디버그 정보를 기록하도록 지정합니다. 오류나 경고가 발생하면 플랫폼에서 디버그 정보를 로그 파일에 게시합니다. 이렇게 하면 오류 또는 경고와 관련된 로그 파일의 일부만 기록됩니다. 오류나 경고가 발견되지 않으면 세션이 닫힐 때 플랫폼에서 사용되지 않은 로그 데이터를 메모리에서 삭제합니다. 각 세션은 최대 1000개의 로그 메시지를 저장합니다. 세션이 1000개의 로그 메시지를 초과하면 지연된 로그가 가장 오래된 로그 메시지를 삭제하여 최신 로그 메시지를 위한 공간을 확보합니다. ServiceNow SSH 클라이언트를 사용하지 않도록 설정하면 이 매개변수는 로그 파일에서 SSh 디버그 정보를 사용하거나 사용하지 않도록 설정합니다. 유형: true | false 기본값: false
debug_ssh	레거시 SSH 클라이언트가 디버그 정보를 agent/logs/agent.log 로그 파일에 기록할지 여부를 지정합니다. 주: 이 로그 파일은 빠르게 커질 수 있으며 필요하지 않은 경우 사용하지 않도록 설정해야 합니다. ServiceNow SSH 클라이언트는 이 매개변수를 사용하지 않습니다. 유형: true | false 기본값: false
timeout	레거시 SSH 클라이언트에 대한 소켓 연결 시간 제한을 설정합니다. ServiceNow SSH 클라이언트는 이 매개변수를 사용하지 않습니다. 유형: 정수(밀리초) 기본값: 60,000
path_override	명령을 실행하기 전에 설정된 기본 경로를 변경하는 방법을 지정합니다. 콜론(:)으로 구분된 하나 이상의 무효화 경로를 입력합니다. 기본 경로는 /usr/sbin: /usr/bin: /bin: /sbin입니다. ServiceNow SSH 클라이언트는 path_overide 값 앞에 있는 다음 프리픽스를 수용합니다. append: 호스트 경로의 끝에 무효화 경로를 추가합니다. 기본 동작입니다. replace: 호스트 경로를 path_overide 값으로 바꿉니다. prepend: 호스트 경로 앞에 무효화 경로를 추가합니다. 형식: 문자열(콜론으로 구분된 디렉터리 목록) 기본값: 없음
keyboard_interactive	keyboard_interactive SSH 로그인 모드를 적용할지 여부를 결정합니다. 유형: true | false 기본값: false
must_sudo	SSH 명령이 sudo를 통해 실행되는지 여부를 결정합니다. 주: must_sudo 프로브 매개변수는 모든 패턴에 영향을 미칩니다. Unix 또는 Linux 호스트에서 패턴을 실행해 여러 가지 명령을 실행할 수 있으며 일부 경우에는 sudo를 추가하지 않아야 합니다. 유형: True | False 기본값: false
run_in_terminal	SSH 명령이 SSH 터미널에서 실행되는지 여부를 결정합니다. 유형: true | false 기본값: ServiceNow SSH 클라이언트: false 레거시 SSH 클라이언트: true
set_path	프로브에서 세션의 PATH 변수를 변경할 수 있는지 여부를 결정합니다. 기본적으로 세션을 설정하는 동안 PATH 변수는 /usr/sbin:/usr/bin:/bin:/sbin으로 설정됩니다. 유형: true | false 기본값: true
rm_override	기본 제거 명령 (/bin/rm -f)를 제공된 값으로 무효화합니다. 유형: 문자열 기본값: 없음
use_snc_ssh	ServiceNow SSH 클라이언트를 사용하도록 설정합니다. ServiceNow SSH 클라이언트는 새 인스턴스에서 기본적으로 활성 상태입니다. ServiceNow SSH 클라이언트를 사용하도록 설정하면 레거시 SSH 클라이언트가 사용하지 않도록 설정됩니다. 유형: true | false 기본값: true
command_timeout_ms	시간 초과 전에 SSH 명령을 실행할 수 있는 시간(밀리초)입니다(기본값은 MID 서버마다 구성 가능). 레거시 SSH 클라이언트는 이 매개변수를 사용하지 않습니다. 유형: 정수 기본값: mid.ssh.command_timeout_ms MID 서버 매개변수의 값입니다.
channel_timeout_ms	MID 서버가 SSH 명령을 처리하는 동안 활동을 기다리는 시간(밀리초)을 지정합니다. MID 서버가 지정된 시간 제한 안에 활동을 탐지하지 못하면 이 매개변수가 명령을 중단합니다. 유형: 정수(밀리초) 기본값: 300000(5분)
preserve_sudo_environment	sudo를 사용하여 SSH를 위한 환경을 유지할지 여부를 지정합니다. 이 매개변수는 조사 중인 호스트의 sudo 환경이 -E 스위치를 지원하는 경우에만 유효합니다. 유형: true | false 기본값: false
credentials_debug	자격 증명 문제 해결에 도움이 되도록 ECC 큐에 <credentials_debug> 섹션을 표시합니다. 이 속성을 true로 설정하면 자격 증명에 성공해도 자격 증명 문제 해결 정보가 ECC 큐로 출력됩니다. 자세한 내용은 자격 증명 문제 해결을 참조하십시오.