Puoi utilizzare il comando sync-cmd e Google Cloud Directory Sync (GCDS) per eseguire le sincronizzazioni dalla riga di comando.
Quando eseguire la sincronizzazione dalla riga di comando
Quando imposti o modifichi la configurazione, devi eseguire una sincronizzazione manuale da Configuration Manager. In questo modo puoi controllare i dati sincronizzati e assicurarti che siano in ordine. Per maggiori dettagli, vedi Eseguire una sincronizzazione manuale.
Una volta finito di modificare la configurazione, puoi automatizzare il processo di sincronizzazione utilizzando la riga di comando. Puoi incorporare le sincronizzazioni in qualsiasi script di pianificazione o batch che desideri utilizzare. In alternativa, puoi utilizzare uno strumento di terze parti per automatizzare le sincronizzazioni. Per maggiori dettagli, vedi Programmare sincronizzazioni automatiche.
Utilizzare la riga di comando
Esegui il comando sync-cmd dalla directory di installazione di GCDS inserendolo su un'unica riga. Puoi utilizzare gli argomenti dei comandi elencati qui sotto per eseguire una serie di azioni, ad esempio:
- Applicare le eventuali modifiche rilevate.
- Leggere un file specificato.
- Imposta il livello di dettaglio del logging.
Suggerimento: per informazioni sugli argomenti dei comandi disponibili, digita sync-cmd -h.
Argomenti ed esempi di comandi
Argomenti comando
| Argomento (utilizza una delle due opzioni) | Descrizione |
|---|---|
-a |
Applica le modifiche rilevate.
Nota:se non utilizzi questo argomento, la sincronizzazione viene eseguita solo come prova e non vengono apportate modifiche al tuo Account Google. Per avere risultati ottimali, esegui una sincronizzazione di prova senza questo argomento prima di eseguire una sincronizzazione completa con l'argomento. |
-c |
Specifica il file di configurazione XML da caricare.
Importante: con questo argomento devi includere un file XML valido. Per maggiori dettagli, vedi Utilizzare i file di configurazione. |
-cs |
Esclude gli schemi personalizzati.
Utilizza questa opzione se non vuoi sincronizzare i dati degli schemi personalizzati per gli utenti. |
-d |
Ignora i limiti di eliminazione configurati. |
-f |
Cancella la copia dei dati del tuo Account Google memorizzata nella cache prima di eseguire la sincronizzazione.
Importante: l'uso improprio può causare una riduzione delle prestazioni. Non utilizzare questa opzione a meno che non venga richiesto dall'assistenza. |
-g |
Esclude i gruppi.
Utilizza questa opzione se intendi sincronizzare gli utenti, ma non i gruppi. |
-h |
Visualizza le informazioni della guida ed esce. |
-l |
Ignora il livello di logging predefinito o configurato con un valore specificato. I valori validi (in ordine crescente di dettaglio) sono FATAL, ERROR, WARN, INFO, DEBUG e TRACE.
Nella maggior parte dei casi, ti consigliamo di impostare il livello di log su INFO. |
-lic |
Sono escluse le licenze.
Utilizza questa opzione se non vuoi sincronizzare i dati delle licenze per gli utenti. |
-o |
Limita le sincronizzazioni in esecuzione a una singola istanza per file di configurazione XML, In questo modo eviti che più istanze vengano eseguite inavvertitamente, ad esempio tramite uno scheduler o un cron job. L'argomento è valido solo con l'argomento Per risolvere il problema, vai a Perché GCDS non esegue una sincronizzazione dalla riga di comando? |
-ou |
Esclude le unità organizzative. |
-r |
Scrive i report in un file di output specificato, oltre che nel log. |
-s |
Esclude i contatti condivisi. |
-u |
Esclude gli utenti.
Utilizza questa opzione se vuoi sincronizzare i gruppi, ma non gli utenti. |
-v |
Visualizza brevi informazioni sulla versione dell'applicazione. |
-V |
Visualizza informazioni dettagliate sulla versione dell'applicazione, ma non le sincronizza. |
Esempi
Windows
Esempio 1: per eseguire una simulazione di sincronizzazione con il file XML di configurazione C:\Utenti\utente\gds-config.xml:
sync-cmd -c C:\Users\user\gdcs-config.xml
Esempio 2: per eseguire una sincronizzazione completa, applicando le modifiche rilevate, con il file XML di configurazione C:\Utenti\utente\gdcs-config.xml:
sync-cmd -a -c C:\Users\user\gdcs-config.xml
Linux
Esempio 1. Per eseguire una simulazione di sincronizzazione con il file XML di configurazione /path/gcds-config.xml:
sync-cmd -c /path/gcds-config.xml
Esempio 2. Per eseguire una sincronizzazione completa, applicando le modifiche rilevate, con il file XML di configurazione /path/gcds-config.xml:
sync-cmd -a -c /path/gcds-config.xml
Esamina il codice di uscita
Dopo aver eseguito la sincronizzazione o la simulazione dalla riga di comando, viene visualizzato uno dei seguenti codici di uscita:
- 0: la sincronizzazione è stata completata senza problemi e tutte le modifiche non superano i limiti configurati.
- 255: simulazione completata. Oppure la sincronizzazione è stata completata e si sono verificati problemi di sincronizzazione, ad esempio modifiche che hanno superato i limiti configurati o un utente che non è riuscito a sincronizzare.
Passaggio successivo
È necessario monitorare regolarmente tutte le sincronizzazioni verificando la presenza di eventuali messaggi di notifica. Per maggiori dettagli, vai a Impostare le notifiche.
Google, Google Workspace e i marchi e loghi correlati sono marchi di Google LLC. Tutti gli altri nomi di società e prodotti sono marchi delle società a cui sono associati.