Je kunt de opdracht sync-cmd en Google Cloud Directory Sync (GCDS) gebruiken om synchronisaties vanaf de opdrachtregel uit te voeren.
Wanneer moet je synchroniseren via de commandoregel?
Wanneer u uw configuratie instelt of wijzigt, moet u een handmatige synchronisatie uitvoeren vanuit Configuratiebeheer. Hiermee kunt u de gesynchroniseerde gegevens controleren en ervoor zorgen dat alles in orde is. Zie Handmatige synchronisatie uitvoeren voor meer informatie.
Nadat u de configuratiewijzigingen hebt aangebracht, kunt u het synchronisatieproces automatiseren via de opdrachtregel. U kunt synchronisaties opnemen in elk gewenst plannings- of batchscript. U kunt ook een tool van derden gebruiken om synchronisaties te automatiseren. Zie Automatische synchronisaties plannen voor meer informatie.
Gebruik de opdrachtregel
U voert de opdracht sync-cmd uit vanuit de GCDS-installatiemap en typt de opdracht op één regel. U kunt de onderstaande opdrachtargumenten gebruiken om verschillende acties uit te voeren, zoals:
- Voer alle gedetecteerde wijzigingen door.
- Lees een specifiek bestand.
- Stel het detailniveau van de logboekregistratie in.
Tip : U kunt informatie over de beschikbare opdrachtargumenten verkrijgen door sync-cmd -h in te voeren.
Argumenten en voorbeelden voor opdrachten
Commando-argumenten
| Argument (gebruik een van beide opties) | Beschrijving |
|---|---|
-a | Past alle gedetecteerde wijzigingen toe. Let op: als u dit argument niet gebruikt, wordt er alleen een testsynchronisatie uitgevoerd en worden er geen wijzigingen in uw Google-account aangebracht. Voor het beste resultaat kunt u het beste eerst een testsynchronisatie zonder dit argument uitvoeren voordat u een volledige synchronisatie met dit argument uitvoert. |
-c | Hiermee wordt het te laden XML-configuratiebestand gespecificeerd. Belangrijk : U moet een geldig XML-bestand bij dit argument voegen. Zie ' Werken met configuratiebestanden' voor meer informatie. |
-cs | Aangepaste schema's zijn uitgesloten. Gebruik deze optie als u geen aangepaste schema-gegevens voor gebruikers wilt synchroniseren. |
-d | Negeert geconfigureerde verwijderingslimieten. |
-f | Hiermee wordt de cachekopie van uw Google-accountgegevens verwijderd voordat de synchronisatie wordt uitgevoerd. Belangrijk : Onjuist gebruik kan leiden tot prestatievermindering. Gebruik deze optie alleen als u hiertoe instructies van de supportafdeling hebt ontvangen. |
-g | Exclusief bepaalde groepen. Gebruik deze optie als u gebruikers wilt synchroniseren, maar geen groepen. |
-h | Toont helpinformatie en sluit af. |
-l | Hiermee wordt het standaard of geconfigureerde logniveau overschreven met een opgegeven waarde. Geldige waarden (in oplopende volgorde van detail) zijn FATAL, ERROR, WARN, INFO, DEBUG en TRACE. In de meeste gevallen raden we aan om het logniveau op INFO in te stellen. |
-lic | Exclusief licenties. Gebruik deze optie als u de licentiegegevens van gebruikers niet wilt synchroniseren. |
-o | Beperkt alle actieve synchronisaties tot één instantie per XML-configuratiebestand. Dit voorkomt dat er onbedoeld meerdere instanties tegelijk draaien (bijvoorbeeld via een scheduler of cronjob). Dit argument is alleen geldig in combinatie met het argument Om problemen op te lossen, ga naar Waarom voert GCDS geen synchronisatie uit vanaf de opdrachtregel? |
-ou | Exclusief organisatie-eenheden. |
-r | Schrijft rapporten naar een opgegeven uitvoerbestand, naast het logbestand. |
-s | Gedeelde contacten zijn uitgesloten. |
-u | Sluit gebruikers uit. Gebruik deze optie als u groepen wilt synchroniseren, maar geen gebruikers. |
-v | Toont korte versie-informatie van de applicatie. |
-V | Geeft gedetailleerde informatie over de applicatieversie weer, maar synchroniseert deze niet. |
Voorbeelden
Windows
Voorbeeld 1 : Voer een gesimuleerde synchronisatie uit met behulp van het XML-configuratiebestand C:\Users\user\gdcs-config.xml:
sync-cmd -c C:\Users\user\gdcs-config.xml
Voorbeeld 2 : Voer een volledige synchronisatie uit, inclusief het toepassen van alle gedetecteerde wijzigingen, met behulp van het XML-configuratiebestand C:\Users\user\gdcs-config.xml:
sync-cmd -a -c C:\Users\user\gdcs-config.xml
Linux
Voorbeeld 1: Voer een gesimuleerde synchronisatie uit met behulp van het XML-configuratiebestand /path/gcds-config.xml:
sync-cmd -c /path/gcds-config.xml
Voorbeeld 2: Voer een volledige synchronisatie uit, inclusief het toepassen van alle gedetecteerde wijzigingen, met behulp van het XML-configuratiebestand /path/gcds-config.xml:
sync-cmd -a -c /path/gcds-config.xml
Controleer de exitcode
Nadat je je synchronisatie of simulatie vanaf de commandoregel hebt uitgevoerd, krijg je een van de volgende exitcodes:
- 0 —Synchronisatie voltooid zonder synchronisatieproblemen en alle wijzigingen overschrijden de geconfigureerde limieten niet.
- 255 —Simulatie voltooid. Of, synchronisatie voltooid maar er zijn synchronisatieproblemen, zoals wijzigingen die de geconfigureerde limieten overschrijden of een gebruiker die niet heeft kunnen synchroniseren.
Volgende stap
U dient alle synchronisaties te controleren door regelmatig te kijken of u meldingen heeft ontvangen. Ga voor meer informatie naar 'Uw meldingen instellen' .
Google, Google Workspace en aanverwante merken en logo's zijn handelsmerken van Google LLC. Alle andere bedrijfs- en productnamen zijn handelsmerken van de bedrijven waaraan ze zijn verbonden.