명령줄을 사용하여 동기화하기

sync-cmd 명령어와 Google Cloud 디렉터리 동기화(GCDS)를 사용하여 명령줄에서 동기화를 실행할 수 있습니다.

명령줄에서 동기화하는 경우

구성을 설정하거나 수정하려면 구성 관리자에서 수동 동기화를 실행해야 합니다. 이렇게 하면 동기화된 데이터를 검사하고 유효한지 확인할 수 있습니다. 자세한 내용은 수동 동기화 수행하기를 참고하세요.

구성을 변경한 후에는 명령줄을 사용하여 동기화 절차를 자동화할 수 있습니다. 일정 예약이나 일괄 스크립트를 사용할 예정이면 동기화 작업을 해당 기능에 통합할 수 있습니다. 또는 서드 파티 도구를 사용하여 동기화를 자동화할 수도 있습니다. 자세한 내용은 자동 동기화 예약하기를 참고하세요.

명령줄 사용하기

GCDS 설치 디렉터리에서 sync-cmd 명령어를 실행하고 명령어를 한 줄에 입력하세요. 아래 표시된 명령어 인수를 사용하여 다음과 같이 다양한 작업을 수행할 수 있습니다.

• 감지된 변경사항 적용
• 특정 파일 읽기
• 로깅 세부정보 수준 설정

도움말: sync-cmd -h를 입력하면 사용 가능한 명령어 인수에 대한 정보를 가져올 수 있습니다.

명령어 인수 및 예제

모두 펼치기  |  모두 접고 상단으로 이동하기

명령어 인수

인수(두 옵션 중 하나 사용)	설명
-a --apply	감지된 변경사항을 적용합니다. 참고: 이 태그를 사용하지 않으면 동기화가 테스트용으로만 실행되므로 Google 계정에 변경사항이 적용되지 않습니다. 최상의 결과를 얻으려면 이 인수 없이 테스트 동기화를 실행한 후에 이 인수를 사용해 전체 동기화를 실행합니다.
-c --config file-name	로드할 XML 구성 파일을 지정합니다. 중요: 이 인수에 유효한 XML 파일을 포함해야 합니다. 자세한 내용은 구성 파일 작업하기를 참고하세요.
-cs --customschemas	맞춤 스키마를 제외합니다. 사용자의 맞춤 스키마 데이터를 동기화하지 않으려면 이 옵션을 사용합니다.
-d --deletelimits	구성된 삭제 한도를 무시합니다.
-f --flush	동기화를 실행하기 전에 Google 계정 데이터의 캐시된 사본을 삭제합니다. 중요: 적절하지 않게 사용하면 성능이 저하될 수 있습니다. 지원팀에서 별도로 지시하지 않는 한 이 옵션은 사용하지 마세요.
-g --groups	그룹을 제외합니다. 사용자만 동기화하고 그룹은 동기화하지 않으려면 이 옵션을 사용합니다.
-h --help	도움말 정보를 표시한 후 종료됩니다.
-l --loglevel value	기본 로그 수준이나 구성된 로그 수준을 지정된 값으로 재정의합니다. 유효한 값은 FATAL, ERROR, WARN, INFO, DEBUG, TRACE이며 이 순서대로 더 세부적인 사항이 포함됩니다. 대부분의 경우 로그 수준을 INFO로 설정하는 것이 좋습니다.
-lic --license	라이선스를 제외합니다. 사용자의 라이선스 데이터를 동기화하지 않으려면 이 옵션을 사용합니다.
-o --oneinstance	실행 중인 동기화를 XML 구성 파일당 하나의 인스턴스로 제한합니다. 이렇게 하면 실수로 여러 인스턴스가 실행되는 것을 방지할 수 있습니다(예: 스케줄러나 크론 작업). 인수는 -a 인수를 사용하는 경우에만 유효합니다. 문제를 해결하려면 GCDS에서 명령줄을 사용한 동기화가 실행되지 않는 이유는 무엇인가요?를 참고하세요.
-ou --orgunit	조직 단위를 제외합니다.
-r --report-out	보고서를 로그뿐 아니라 지정된 출력 파일로도 내보냅니다.
-s --sharedcontacts	공유 주소록를 제외합니다.
-u --users	사용자를 제외합니다. 그룹만 동기화하고 사용자는 동기화하지 않으려면 이 옵션을 사용합니다.
-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의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표입니다.}