혜택

이를 통해 ServiceNow CLI 다음을 수행할 수 있습니다.

• 인스턴스의 기록에 대해 기본 CRUD 작업을 수행합니다.
• 사용자 지정 구성요소를 개발하고 인스턴스에 배포하여 UI를 개인화합니다.
• 명령줄에서 사용자 지정 애플리케이션을 관리할 수 있는 사용자 지정 명령을 만듭니다.
• 스크립트에 있는 스크립트 ServiceNow CLI 를 사용하여 설정 작업과 운영 활동을 단순화할 수 있습니다.

아키텍처

명령은 연결된 인스턴스의 테이블에 저장됩니다. 가 ServiceNow CLI 인스턴스에 연결하면 해당 인스턴스에서 지원하는 사용 가능한 모든 명령을 받습니다.

명령은 비동기식으로 실행되는 REST 엔드포인트에 매핑됩니다. 자세한 내용은 ServiceNow CLI에서 사용자 지정 명령 생성 문서를 참조하십시오.

ServiceNow CLI 활성화 중

ServiceNow Store에서 요청하여 ServiceNow CLI를 설치합니다. 사용 가능한 모든 앱을 보고 스토어에 요청을 제출하는 방법에 대한 자세한 내용을 보려면 다음을 ServiceNow Store 방문하십시오. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.

구성 파일

ServiceNow CLI 프로파일 정보를 config.json 파일에 저장하며, 기본적으로 다음 경로의 홈 디렉토리에 저장됩니다.

CLI는 이 파일을 사용하여 인스턴스에 연결하는 데 사용할 정보와 출력을 생성하는 데 사용할 설정을 결정합니다. 기본적으로 에서는 ServiceNow CLI기본 프로파일에 있는 설정을 사용하여 인스턴스에 연결합니다. 대체 설정을 사용하려면 명명된 추가 프로파일을 만들고 참조할 수 있습니다. 자세한 내용은 연결 프로파일 구성 및 관리 ServiceNow CLI 문서를 참조하십시오.

다음 예는 기본 프로파일과 명명된 프로파일이 있는 구성 파일을 보여줍니다. 각 프로파일은 서로 다른 자격 증명을 사용하고 서로 다른 호스트 및 출력 형식을 지정할 수 있습니다.

{
   "profiles":{
      "default":{
         "host":"https://myinstance.service-now.com",
         "loginmethod":"basic",
         "username":"admin",
         "output":"json",  
         "hostversion":"Paris",
         "appversion":"1.0"
         },
      "user1":{
         "host":"https://otherinstance.service-now.com",
         "loginmethod":"basic",
         "username":"user1",
         "output":"yaml",
         "hostversion":"Paris",
         "appversion":"1.0"
         }
      }
}

명령 구조

ServiceNow CLI 명령은 다음 구조를 따릅니다.

1. snc 프로그램에 대한 기본 호출입니다.
2. 하위 명령 그룹 뒤에 오는 최상위 명령 그룹입니다.
3. 수행할 작업을 지정하는 명령입니다.
4. 작업에 필요한 일반 CLI 인수입니다. 순서에 관계없이 인수를 지정할 수 있습니다.

$ snc <command-group> <command> [arguments]

인수는 숫자, 문자열 및 JSON 객체와 같은 다양한 유형의 입력 값을 사용할 수 있습니다. 지원되는 유형은 지정하는 명령에 따라 다릅니다.

인수 값

의 많은 ServiceNow CLI 인수 값은 다음 예시의 테이블 및 테이블 이름과 같은 단순한 문자열 또는 숫자 값입니다.

$ snc record create --table incident --data "{short_description: 'New Incident'}"

공백 문자가 포함되지 않은 문자열을 따옴표로 묶거나 사용하지 않을 수 있습니다. 단, 하나 이상의 공백 문자가 포함된 문자열 주위에 따옴표를 사용해야 합니다.

출력 형식

네 ServiceNow CLI 가지 출력 형식을 지원합니다.

• json: 출력 형식은 json입니다. 이것이 기본값입니다.

  
  {
     "default": {
        "appversion": "1.0.8",
        "host": "https://myinstance.service-now.com",
        "hostversion": "Paris",
        "loginmethod": "basic",
        "output": "json",
        "username": "admin"
     },
     "user1": {
        "appversion": "1.0.8",
        "host": "https://otherinstance.service-now.com",
        "hostversion": "Paris",
        "loginmethod": "basic",
        "output": "yaml",
        "username": "admin"
     }
  }

• yaml: 출력 형식이 YAML로 지정됩니다. YAML을 사용하여 YAML 형식의 문자열을 내보내거나 사용하는 서비스 및 도구로 출력을 처리합니다.

  default:
     appversion: 1.0.8
     host: https://myinstance.service-now.com
     hostversion: Paris
     loginmethod: basic
     output: json
     username: admin
  user1:
     appversion: 1.0.8
     host: https://otherinstance.service-now.com
     hostversion: Paris
     loginmethod: basic
     output: yaml
     username: admin

• text: 출력 형식은 여러 줄의 탭으로 구분된 문자열 값으로 지정됩니다. 이 출력을 grep, sed 및 awk와 같은 기존 UNIX 텍스트 도구 및 PowerShell에서 수행하는 텍스트 처리에 사용합니다.

  default   https://myinstance.service-now.com   Paris   1.0.8   basic   admin   json 
  user1   https://otherinstance.service-now.com   Paris   1.0.8   basic   admin   yaml

• table: 출력 형식은 사람이 읽을 수 있는 형식으로 정보를 제공하는 테이블로 지정됩니다.

  NAME   HOST   HOST   VERSION   APP   VERSION   LOGIN   METHOD   USERNAME   OUTPUT 
  -------------------------------------------------------------------------------
  default   myinstance   Paris   1.0.8   basic   admin   json 
  user1   otherinstance   Paris   1.0.8   basic   admin   yaml

• none: CLI는 출력을 콘솔에 인쇄하지 않습니다. 성공, 오류 및 진행률 메시지는 여전히 표시됩니다.

다음 두 가지 방법으로 명령 출력을 지정할 수 있습니다.