sync-cmd 명령어와 Google Cloud 디렉터리 동기화 (GCDS)를 사용하여 명령줄에서 동기화를 실행할 수 있습니다.
명령줄에서 동기화하는 경우
구성을 설정하거나 수정하려면 구성 관리자에서 수동 동기화를 실행해야 합니다. 이렇게 하면 동기화된 데이터를 검사하고 유효한지 확인할 수 있습니다. 자세한 내용은 수동 동기화 실행하기를 참고하세요.
구성을 변경한 후에는 명령줄을 사용하여 동기화 절차를 자동화할 수 있습니다. 일정 예약이나 일괄 스크립트를 사용할 예정이면 동기화 작업을 해당 기능에 통합할 수 있습니다. 또는 서드 파티 도구를 사용하여 동기화를 자동화할 수도 있습니다. 자세한 내용은 자동 동기화 예약하기를 참고하세요.
명령줄 사용하기
GCDS 설치 디렉터리에서 sync-cmd 명령어를 실행하고 명령어를 한 줄에 입력하세요. 아래 표시된 명령어 인수를 사용하여 다음과 같이 다양한 작업을 수행할 수 있습니다.
- 감지된 변경사항 적용
- 특정 파일 읽기
- 로깅 세부정보 수준 설정
도움말: sync-cmd -h를 입력하면 사용 가능한 명령어 인수에 대한 정보를 가져올 수 있습니다.
명령어 인수 및 예제
명령 인수
| 인수(두 옵션 중 하나 사용) | 설명 |
|---|---|
-a |
감지된 변경사항을 적용합니다.
참고: 이 태그를 사용하지 않으면 동기화가 테스트용으로만 실행되므로 Google 계정에 변경사항이 적용되지 않습니다. 최상의 결과를 얻으려면 이 인수 없이 테스트 동기화를 실행한 후에 이 인수를 사용해 전체 동기화를 실행합니다. |
-c |
로드할 XML 구성 파일을 지정합니다.
중요: 이 인수에 유효한 XML 파일을 포함해야 합니다. 자세한 내용은 구성 파일 작업하기를 참고하세요. |
-cs |
맞춤 스키마를 제외합니다.
사용자의 맞춤 스키마 데이터를 동기화하지 않으려면 이 옵션을 사용합니다. |
-d |
구성된 삭제 한도를 무시합니다. |
-f |
동기화를 실행하기 전에 Google 계정 데이터의 캐시된 사본을 삭제합니다.
중요: 적절하지 않게 사용하면 성능이 저하될 수 있습니다. 지원팀에서 별도로 지시하지 않는 한 이 옵션은 사용하지 마세요. |
-g |
그룹을 제외합니다.
사용자만 동기화하고 그룹은 동기화하지 않으려면 이 옵션을 사용합니다. |
-h |
도움말 정보를 표시한 후 종료됩니다. |
-l |
기본 로그 수준이나 구성된 로그 수준을 지정된 값으로 재정의합니다. 유효한 값은 FATAL, ERROR, WARN, INFO, DEBUG, TRACE이며 이 순서대로 더 세부적인 사항이 포함됩니다.
대부분의 경우 로그 수준을 INFO로 설정하는 것이 좋습니다. |
-lic |
라이선스를 제외합니다.
사용자의 라이선스 데이터를 동기화하지 않으려면 이 옵션을 사용합니다. |
-o |
실행 중인 동기화를 XML 구성 파일당 하나의 인스턴스로 제한합니다. 이렇게 하면 실수로 여러 인스턴스가 실행되는 것을 방지할 수 있습니다(예: 스케줄러나 크론 작업). 인수는 문제를 해결하려면 GCDS에서 명령줄을 사용한 동기화가 실행되지 않는 이유는 무엇인가요?를 참고하세요. |
-ou |
조직 단위를 제외합니다. |
-r |
보고서를 로그뿐 아니라 지정된 출력 파일로도 내보냅니다. |
-s |
공유 주소록를 제외합니다. |
-u |
사용자를 제외합니다.
그룹만 동기화하고 사용자는 동기화하지 않으려면 이 옵션을 사용합니다. |
-v |
간략한 애플리케이션 버전 정보를 표시합니다. |
-V |
동기화를 실행하지 않고 상세한 애플리케이션 버전 정보를 표시합니다. |
예
Windows
예 1: 다음과 같이 XML 구성 파일 C:\Users\user\gdcs-config.xml을 사용하여 시뮬레이션 동기화를 실행합니다.
sync-cmd -c C:\Users\user\gdcs-config.xml
예 2: 다음과 같이 XML 구성 파일 C:\Users\user\gdcs-config.xml을 사용하여 전체 동기화를 실행하고 모든 감지된 변경사항을 적용합니다.
sync-cmd -a -c C:\Users\user\gdcs-config.xml
Linux
예 1: 다음과 같이 XML 구성 파일 /path/gcds-config.xml을 사용하여 시뮬레이션 동기화를 실행합니다.
sync-cmd -c /path/gcds-config.xml
예 2: 다음과 같이 XML 구성 파일 /path/gcds-config.xml을 사용하여 전체 동기화를 실행하고 변경사항을 적용합니다.
sync-cmd -a -c /path/gcds-config.xml
종료 코드 검토
명령줄에서 동기화 또는 시뮬레이션을 실행하면 다음 종료 코드 중 하나가 표시됩니다.
- 0: 동기화 문제 없이 동기화가 완료되었으며 모든 수정사항이 구성된 제한을 초과하지 않습니다.
- 255: 시뮬레이션이 완료되었습니다. 또는 동기화가 완료되었지만 구성된 제한을 초과하는 수정사항이나 사용자가 동기화에 실패하는 등 동기화 문제가 있는 경우입니다.
다음 단계
정기적으로 알림 메시지를 확인하여 모든 동기화를 모니터링해야 합니다. 자세한 내용은 알림 설정하기를 참고하세요.
Google, Google Workspace, 관련 마크와 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표입니다.