--- sourceDocument: 호주 애플리케이션 빌드 또는 수정 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/application-development Release : - australia ft:locale : - ko-KR ft:publication_title : - 호주 애플리케이션 빌드 또는 수정 ft:clusterId : - cadev bundleId : - cadev workflow : - Development, Data, and Analytics --- # ServiceNow CLI # ServiceNow CLI {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분 ServiceNow CLI 로컬 시스템에서 인스턴스 작업을 수행할 수 있는 명령줄 인터페이스입니다. CLI를 확장하여 애플리케이션 요구 사항을 충족하는 새 명령을 포함할 수 있습니다. ## 혜택 {#servicenow-cli__section_a1z_jcg_f4b} 이를 통해 ServiceNow CLI 다음을 수행할 수 있습니다. * 인스턴스의 기록에 대해 기본 CRUD 작업을 수행합니다. * 사용자 지정 구성요소를 개발하고 인스턴스에 배포하여 UI를 개인화합니다. * 명령줄에서 사용자 지정 애플리케이션을 관리할 수 있는 사용자 지정 명령을 만듭니다. * 스크립트에 있는 스크립트 ServiceNow CLI 를 사용하여 설정 작업과 운영 활동을 단순화할 수 있습니다. {#servicenow-cli__ul_stw_lcg_f4b} ## 아키텍처 {#servicenow-cli__section_mrl_kbh_f4b} 명령은 연결된 인스턴스의 테이블에 저장됩니다. 가 ServiceNow CLI 인스턴스에 연결하면 해당 인스턴스에서 지원하는 사용 가능한 모든 명령을 받습니다. 명령은 비동기식으로 실행되는 REST 엔드포인트에 매핑됩니다. 자세한 내용은 [ServiceNow CLI에서 사용자 지정 명령 생성](https://servicenow-prod.fluidtopics.net/x6waQeFUitamWOyMjtzRFA "ServiceNow CLI에서 사용자 지정 명령을 생성하여 명령줄에서 사용자 지정 애플리케이션을 관리합니다.") 문서를 참조하십시오. ## ServiceNow CLI 활성화 중 {#servicenow-cli__section_mkq_tcr_2nb} ServiceNow Store에서 요청하여 ServiceNow CLI를 설치합니다. 사용 가능한 모든 앱을 보고 스토어에 요청을 제출하는 방법에 대한 자세한 내용을 보려면 다음을 [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) 방문하십시오. 출시된 모든 앱의 누적 릴리스 정보는 [ServiceNow Store 버전 기록 릴리스 정보](https://docs.servicenow.com/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html)를 참조하십시오.{#servicenow-cli__servicenow-cli-rn-activation} ## 구성 파일 {#servicenow-cli__section_g4p_fzt_j4b} ServiceNow CLI 프로파일 정보를 config.json 파일에 저장하며, 기본적으로 다음 경로의 홈 디렉토리에 저장됩니다. * Linux 및 Mac: \~/.snc/config.json * Windows: %USERPROFILE%\\.snc\\config.json {#servicenow-cli__ul_evp_nf5_j4b} CLI는 이 파일을 사용하여 인스턴스에 연결하는 데 사용할 정보와 출력을 생성하는 데 사용할 설정을 결정합니다. 기본적으로 에서는 ServiceNow CLI기본 프로파일에 있는 설정을 사용하여 인스턴스에 연결합니다. 대체 설정을 사용하려면 명명된 추가 프로파일을 만들고 참조할 수 있습니다. 자세한 내용은 [연결 프로파일 구성 및 관리 ServiceNow CLI](https://servicenow-prod.fluidtopics.net/k1LhnYN9JBih8zunclY2Dg "인스턴스에 연결하거나, 연결 프로파일을 보고, 연결 및 사용 가능한 명령을 새로 고치거나, 더 이상 필요하지 않은 프로파일을 삭제할 연결 프로파일을 생성합니다.") 문서를 참조하십시오. 다음 예는 기본 프로파일과 명명된 프로파일이 있는 구성 파일을 보여줍니다. 각 프로파일은 서로 다른 자격 증명을 사용하고 서로 다른 호스트 및 출력 형식을 지정할 수 있습니다. { "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" } } } 주: 중요한 자격 증명 정보는 구성 파일이 아닌 OS 키체인에만 저장됩니다. ## 명령 구조 {#servicenow-cli__section_igh_ysm_j4b} ServiceNow CLI 명령은 다음 구조를 따릅니다. 1. `snc` 프로그램에 대한 기본 호출입니다. 2. 하위 명령 그룹 뒤에 오는 최상위 명령 그룹입니다. 3. 수행할 작업을 지정하는 명령입니다. 4. 작업에 필요한 일반 CLI 인수입니다. 순서에 관계없이 인수를 지정할 수 있습니다. {#servicenow-cli__ol_nz1_nrm_j4b} $ snc [arguments] 인수는 숫자, 문자열 및 JSON 객체와 같은 다양한 유형의 입력 값을 사용할 수 있습니다. 지원되는 유형은 지정하는 명령에 따라 다릅니다. ## 인수 값 {#servicenow-cli__section_hs4_4vt_j4b} 의 많은 ServiceNow CLI 인수 값은 다음 예시의 테이블 및 테이블 이름과 같은 단순한 문자열 또는 숫자 값입니다. $ snc record create --table incident --data "{short_description: 'New Incident'}" 공백 문자가 포함되지 않은 문자열을 따옴표로 묶거나 사용하지 않을 수 있습니다. 단, 하나 이상의 공백 문자가 포함된 문자열 주위에 따옴표를 사용해야 합니다. ## 출력 형식 {#servicenow-cli__section_zkf_xst_j4b} 네 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는 출력을 콘솔에 인쇄하지 않습니다. 성공, 오류 및 진행률 메시지는 여전히 표시됩니다. {#servicenow-cli__ul_zwq_zdt_l4b} 다음 두 가지 방법으로 명령 출력을 지정할 수 있습니다. 구성 파일의 명명된 프로파일에서 `출력` 옵션을 사용합니다 : 다음 예제에서는 기본 출력 형식을 텍스트로 설정합니다. { "profiles":{ "default":{ "output":"text" } } 명령줄에서 `--output` 인수를 사용합니다. : 다음 예제에서는 단일 명령의 출력을 JSON으로 설정합니다. 명령의 이 옵션은 구성 파일에서 현재 설정된 값을 무효화합니다. $ snc record query --table incident --query 'active=true' --output json * **[ServiceNow CLI 설치](https://servicenow-prod.fluidtopics.net/mUbWjc9CzWbWzPhDIdKqFQ)** Mac, Windows 또는 Linux 컴퓨터에 설치합니다 ServiceNow CLI . * **[연결 프로파일 구성 및 관리 ServiceNow CLI](https://servicenow-prod.fluidtopics.net/k1LhnYN9JBih8zunclY2Dg)** 인스턴스에 연결하거나, 연결 프로파일을 보고, 연결 및 사용 가능한 명령을 새로 고치거나, 더 이상 필요하지 않은 프로파일을 삭제할 연결 프로파일을 생성합니다. * **[ServiceNow CLI에 대한 도움 받기](https://servicenow-prod.fluidtopics.net/ggLgFSk2lJpONMD3D2ZyjQ)** 사용 가능한 명령, 명령 옵션 및 예제를 확인하거나 디버그 로깅 출력을 생성합니다. * **[ServiceNow CLI를 사용하여 기록 작업 수행](https://servicenow-prod.fluidtopics.net/h2Gh989iyUF1exZdpCfLow)** 명령줄 도구를 사용하여 인스턴스에서 기록을 생성, 읽기, 업데이트, 삭제 및 쿼리합니다.ServiceNow CLI * **[ServiceNow CLI에서 사용자 지정 명령 생성](https://servicenow-prod.fluidtopics.net/x6waQeFUitamWOyMjtzRFA)** ServiceNow CLI에서 사용자 지정 명령을 생성하여 명령줄에서 사용자 지정 애플리케이션을 관리합니다. * **[확장 관리 ServiceNow CLI](https://servicenow-prod.fluidtopics.net/Co54gAO80KQT~BB4gsIL_w)** 에 확장을 ServiceNow CLI 추가하여 추가 기능과 명령을 로드하거나, 기존 확장을 업데이트하거나, 더 이상 필요하지 않은 확장을 제거합니다. * **[ServiceNow CLI 사용 가능한 명령](https://servicenow-prod.fluidtopics.net/UBcwPvMxdvlqm_~xvIbgLA)** 기본 시스템에서 ServiceNow CLI사용할 수 있는 명령 및 명령 인수 . * **[애플리케이션 CLI 및 API와 함께 CMDB 설치되는 명령어](https://servicenow-prod.fluidtopics.net/A5GmrxU14eIUxR8EOElCIg)** app-cmdb-api-cli 플러그인이 설치될 때 사용할 수 있는 ServiceNow CLI 명령 및 명령 그룹입니다.