Você pode usar o comando sync-cmd
e Google Cloud Directory Sync (GCDS) para fazer sincronizações na linha de comando.
Quando sincronizar usando a linha de comando
Ao definir ou modificar sua configuração, faça uma sincronização manual no Gerenciador de configuração. Isso permite que você verifique os dados sincronizados e confira se eles estão em ordem. Veja mais detalhes em Fazer uma sincronização manual.
Após concluir as alterações na configuração, você poderá automatizar o processo de sincronização usando a linha de comando. Você pode incorporar sincronizações a qualquer programação ou script de lote que queira usar. Também é possível usar ferramentas de terceiros para automatizar sincronizações. Veja mais detalhes em Programar sincronizações automáticas.
Usar a linha de comando
Execute o comando sync-cmd
no diretório de instalação do GCDS digitando-o em uma única linha. Você pode usar os argumentos de comando listados abaixo para realizar uma série de ações, como:
- aplicar as alterações detectadas;
- ler um arquivo especificado;
- definir o nível de detalhe do registro.
Dica: para ver informações sobre os argumentos de comando disponíveis, insira sync-cmd -h
.
Argumentos e exemplos de comando
Expandir tudo | Recolher tudo e voltar ao início
Argumentos de comandoArgumento (use qualquer opção) | Descrição |
---|---|
-a |
Aplica as mudanças detectadas.
Observação: se você não usar esse argumento, uma sincronização será executada somente como teste e nenhuma alteração será feita na Conta do Google. Para ter os melhores resultados, faça uma sincronização de teste sem esse argumento antes de executar uma sincronização completa com ele. |
-c |
Especifica o arquivo de configuração XML que será carregado.
Importante: é preciso incluir um arquivo XML válido com esse argumento. Veja mais detalhes em Trabalhar com arquivos de configuração. |
-cs |
Exclui esquemas personalizados.
Use essa opção se você não quiser sincronizar os dados de esquemas personalizados dos usuários. |
-d |
Ignora os limites de exclusão configurados. |
-f |
Limpa a cópia em cache dos dados da sua Conta do Google antes de fazer a sincronização.
Importante: o uso inadequado pode prejudicar o desempenho. Não use esta opção, a menos que seja orientado pelo suporte. |
-g |
Exclui grupos.
Use esta opção se você quiser sincronizar apenas usuários. |
-h |
Exibe informações de ajuda e saídas. |
-l |
Substitui o nível de registro padrão ou configurado por um valor especificado. Os valores válidos (em ordem de detalhamento crescente) são FATAL, ERROR, WARN, INFO, DEBUG e TRACE.
Na maioria dos casos, recomendamos definir o nível de registro como INFO. |
-lic |
Exclui licenças.
Use essa opção se você não quiser sincronizar os dados de licença dos usuários. |
-o |
Restringe qualquer sincronização em execução a uma única instância por arquivo de configuração XML. Isso evita que várias instâncias sejam executadas acidentalmente (por exemplo, por um programador ou cron job). O argumento só é válido com o argumento Veja como resolver problemas em Por que o GCDS não está fazendo uma sincronização na linha de comando? |
-ou |
Exclui unidades organizacionais. |
-r |
Grava relatórios em um arquivo de saída especificado, além do registro. |
-s |
Exclui contatos compartilhados. |
-u |
Exclui usuários.
Use essa opção se quiser sincronizar grupos, mas não usuários |
-v |
Exibe informações resumidas da versão do aplicativo. |
-V |
Mostra informações detalhadas da versão do aplicativo, mas não sincroniza. |
Windows
Exemplo 1: faça uma sincronização simulada usando o arquivo de configuração XML C:\Users\user\gdcs-config.xml:
sync-cmd -c C:\Users\user\gdcs-config.xml
Exemplo 2: faça uma sincronização completa, inclusive aplicando as alterações detectadas, com o arquivo de configuração XML C:\Users\user\gdcs-config.xml:
sync-cmd -a -c C:\Users\user\gdcs-config.xml
Linux
Exemplo 1: faça uma sincronização simulada usando o arquivo de configuração XML "/path/gcds-config.xml":
sync-cmd -c /path/gcds-config.xml
Exemplo 2: faça uma sincronização completa, inclusive aplicando as alterações detectadas, usando o arquivo de configuração XML "/path/gcds-config.xml".
sync-cmd -a -c /path/gcds-config.xml
Revisar código de saída
Depois de executar a sincronização ou simulação na linha de comando, você receberá um dos seguintes códigos de saída:
- 0: a sincronização é concluída sem problemas de sincronização, e todas as modificações não excedem os limites configurados.
- 255: simulação concluída. Ou então, a sincronização foi concluída e ocorreram problemas de sincronização, como modificações que excederam os limites configurados ou um usuário não conseguiu sincronizar.
Próxima etapa
Google, Google Workspace e marcas e logotipos relacionados são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos são marcas registradas das empresas às quais eles estão associados.