Synkronisera med hjälp av kommandoraden

Du kan använda kommandot sync-cmd och Google Cloud Directory Sync (GCDS) för att köra synkroniseringar från kommandoraden.

När ska man synkronisera från kommandoraden

När du konfigurerar eller ändrar din konfiguration bör du köra en manuell synkronisering från Konfigurationshanteraren. På så sätt kan du kontrollera synkroniserade data och se till att de är i sin ordning. Mer information finns i Utför en manuell synkronisering .

När du är klar med konfigurationsändringarna kan du automatisera din synkroniseringsprocess med hjälp av kommandoraden. Du kan integrera synkroniseringar i valfritt schemaläggnings- eller batchskript. Alternativt kan du använda ett tredjepartsverktyg för att automatisera synkroniseringar. För mer information, gå till Schemalägg automatiska synkroniseringar .

Använd kommandoraden

Du kör kommandot sync-cmd från GCDS-installationskatalogen och anger kommandot på en enda rad. Du kan använda kommandoargumenten nedan för att utföra en rad olika åtgärder, till exempel:

  • Tillämpa alla upptäckta ändringar.
  • Läs en specificerad fil.
  • Ange detaljnivån för loggningen.

Tips : Du kan få information om tillgängliga kommandoargument genom att skriva sync-cmd -h .

Kommandoargument och exempel

Kommandoargument

Argument (använd något av alternativen) Beskrivning
-a
--apply		 Tillämpar alla upptäckta ändringar.

Obs! Om du inte använder det här argumentet körs en synkronisering endast som ett test och inga ändringar görs i ditt Google-konto. För bästa resultat, kör en testsynkronisering utan det här argumentet innan du kör en fullständig synkronisering med den.

-c
--config file-name		 Anger vilken XML-konfigurationsfil som ska läsas in.

Viktigt : Du måste inkludera en giltig XML-fil med detta argument. För mer information, gå till Arbeta med konfigurationsfiler .

-cs
--customschemas		 Exkluderar anpassade scheman.

Använd det här alternativet om du inte vill synkronisera anpassade schemadata för användare.

-d
--deletelimits		 Ignorerar konfigurerade borttagningsgränser.
-f
--flush		 Rensar den cachade kopian av dina Google-kontodata innan synkroniseringen körs.

Viktigt : Felaktig användning kan orsaka försämrad prestanda. Använd inte det här alternativet om inte supporten instruerar dig att göra det.

-g
--groups		 Exkluderar grupper.

Använd det här alternativet om du vill synkronisera användare, men inte grupper.

-h
--help		 Visar hjälpinformation och avslutar.
-l
--loglevel value		 Åsidosätter standard- eller konfigurerad loggnivå med ett angivet värde. Giltiga värden (i stigande detaljordning) är FATAL, ERROR, WARN, INFO, DEBUG och TRACE.

I de flesta fall rekommenderar vi att du ställer in loggnivån till INFO.

-lic
--license		 Exkluderar licenser.

Använd det här alternativet om du inte vill synkronisera licensdata för användare.

-o
--oneinstance

Begränsar alla pågående synkroniseringar till en enda instans per XML-konfigurationsfil. Detta förhindrar att flera instanser körs oavsiktligt (till exempel via en schemaläggare eller ett cron-jobb). Argumentet är endast giltigt med argumentet -a .

För att felsöka, gå till Varför kör inte GCDS en synkronisering från kommandoraden?

-ou
--orgunit		 Exkluderar organisatoriska enheter.
-r
--report-out		 Skriver rapporter till en specificerad utdatafil, utöver loggen.
-s
--sharedcontacts		 Exkluderar delade kontakter.
-u
--users		 Exkluderar användare.

Använd det här alternativet om du vill synkronisera grupper, men inte användare.

-v Visar kort information om programversionen.
-V Visar detaljerad information om programversionen, men synkroniserar den inte.

Exempel

Fönster

Exempel 1 : Kör en simulerad synkronisering med XML-konfigurationsfilen C:\Users\user\gdcs-config.xml:

sync-cmd -c C:\Users\user\gdcs-config.xml

Exempel 2 : Kör en fullständig synkronisering, inklusive tillämpning av eventuella upptäckta ändringar, med XML-konfigurationsfilen C:\Users\user\gdcs-config.xml:

sync-cmd -a -c C:\Users\user\gdcs-config.xml

Linux

Exempel 1: Kör en simulerad synkronisering med XML-konfigurationsfilen /path/gcds-config.xml:

sync-cmd -c /path/gcds-config.xml

Exempel 2: Kör en fullständig synkronisering, inklusive tillämpning av eventuella upptäckta ändringar, med XML-konfigurationsfilen /path/gcds-config.xml:

sync-cmd -a -c /path/gcds-config.xml

Granska utgångskoden

När du har kört din synkronisering eller simulering från kommandoraden får du en av följande avslutningskoder:

  • 0 —Synkroniseringen är slutförd utan synkroniseringsproblem och alla ändringar överskrider inte de konfigurerade gränserna.
  • 255 —Simuleringen är klar. Eller så är synkroniseringen klar och det finns synkroniseringsproblem, till exempel ändringar som överskridit de konfigurerade gränserna eller att en användare misslyckades med att synkronisera.

Nästa steg

Du bör övervaka alla synkroniseringar genom att regelbundet kontrollera om det finns några aviseringar. För mer information, gå till Ställ in dina aviseringar .


Google, Google Workspace och relaterade varumärken och logotyper är varumärken som tillhör Google LLC. Alla andra företags- och produktnamn är varumärken som tillhör de företag som de är associerade med.