Mediensynchronisierung: CLI-Befehle

Fügt Ihre eigene Microsoft-Entra-App oder eine Microsoft-Verbindung des Projekts hinzu, damit eine Synchronisierung einen SharePoint- oder OneDrive-for-Work-Ordner lesen kann.

media sync account add microsoft365 --name NAME
    (--tenant-id TENANT --client-id ID --secret-file FILE | --connection-id ID)

screenrig media sync account add microsoft365 --name Contoso --tenant-id contoso.onmicrosoft.com --client-id 0b1d2f3a-4c5e-4f60-8a7b-9c0d1e2f3a4b --secret-file secret.txt
screenrig media sync account add microsoft365 --name Contoso --connection-id pcn_01EXAMPLECONNECTION0000

Registrieren Sie im Microsoft-Entra-Admin-Center eine App mit nur einem Mandanten ohne Weiterleitungs-URI, fügen Sie ein Client-Secret hinzu (kopieren Sie seinen Wert, nicht die Secret-ID), fügen Sie die Microsoft-Graph-Anwendungsberechtigung Sites.Selected hinzu (erteilen Sie der App dann Lesezugriff auf jede Site) oder Files.Read.All und erteilen Sie die Administratorzustimmung. Die App gehört zu diesem Projekt. Führen Sie als Nächstes media sync account test aus.

Fügt ein Dropbox-Konto hinzu und gibt den einmaligen Link aus, den die Person, der das Konto gehört, bei Dropbox angemeldet öffnet, um es zu verbinden.

media sync account add dropbox --name NAME [--app-key KEY]

screenrig media sync account add dropbox --name "Marketing Dropbox"
screenrig media sync account add dropbox --name "Marketing Dropbox" --app-key YOURAPPKEY

data.authorize_url ist der Link und data.authorize_expires_at sein Ablauf. Die CLI öffnet nie einen Browser: Senden Sie den Link an die Person, der das Dropbox-Konto gehört und die den Lesezugriff erlaubt (files.metadata.read, files.content.read, account_info.read, sharing.read). Führen Sie media sync account show aus, bis data.state den Wert ready hat (zu Beginn ist es pending_consent), und dann media sync create dropbox. Ihre eigene Dropbox-App braucht diese aktivierten Berechtigungen und die Redirect-URI, die die Ausgabe nennt.

Fügt ein Google-Drive-Konto hinzu, sofort bereit, und gibt die Dienstkonto-Adresse aus, für die Ordner freigegeben werden.

media sync account add google-drive --name NAME [--key-file FILE]

screenrig media sync account add google-drive --name "Marketing Drive"
screenrig media sync account add google-drive --name "Marketing Drive" --key-file key.json

data.config.service_account_email ist die Adresse, für die jeder Ordner freigegeben wird; Viewer genügt. Über das Dienstkonto von screenRIG wird ein Ordner nur synchronisiert, wenn ein Mitglied dieses Projekts mit verifizierter E-Mail ihn freigegeben hat oder besitzt (sonst media_sync_sharer_not_member). Mit Ihrem eigenen Schlüssel wird jeder für das Dienstkonto freigegebene Ordner synchronisiert.

Listet die Konten der Mediensynchronisierung dieses Projekts mit Art, Zustand und letztem Test auf; es wird kein Secret zurückgegeben.

media sync account list

Keine Parameter.

screenrig media sync account list

Zeigt ein Konto: seinen Mandanten und die Client-ID, den Zustand, das maskierte Secret und den letzten Test.

media sync account show <id>

screenrig media sync account show msa_01EXAMPLEACCOUNT0000000

Ein Dropbox-Konto zeigt zusätzlich, wer es verbunden hat, sowie app_key; ein Google-Drive-Konto zeigt zusätzlich service_account_email.

Benennt ein Konto um, ändert Mandant, Anwendungs-ID oder Client-Secret einer Microsoft-App oder ersetzt den eigenen Schlüssel eines Google-Drive-Kontos.

media sync account update <id> [--name NAME] [--tenant-id TENANT] [--client-id ID]
    [--secret-file FILE | --key-file FILE] [--expect-rev REVISION]

screenrig media sync account update msa_01EXAMPLEACCOUNT0000000 --secret-file new-secret.txt
screenrig media sync account update msa_01EXAMPLEACCOUNT0000000 --name "Contoso tenant" --expect-rev 2

Mindestens eine Änderung ist erforderlich. Eine Änderung der Zugangsdaten löscht last_test: Testen Sie das Konto erneut. Client-Secrets von Entra laufen ab, ersetzen Sie das Secret hier also, bevor es so weit ist.

Erzeugt einen neuen einmaligen Link, um ein Dropbox-Konto zu verbinden oder erneut zu verbinden.

media sync account connect <id>

screenrig media sync account connect msa_01EXAMPLEACCOUNT0000000

data.authorize_url und data.authorize_expires_at tragen den Link, der den früheren ersetzt. Senden Sie ihn an die Person, der das Dropbox-Konto gehört. Verwenden Sie ihn, wenn die Person den Vorgang nicht abgeschlossen hat oder das Konto reconnect_required ist (Dropbox erkennt die Verbindung nicht mehr an). Ein verbundenes Konto bleibt verbunden, bis die neue Zustimmung abgeschlossen ist, und ein anderes Dropbox-Konto, das sich anmeldet, übernimmt die Verbindung.

Prüft ein Konto: die Anmeldung und die Graph-Berechtigungen einer Microsoft-App oder die Verbindung oder den Schlüssel eines Dropbox- oder Google-Drive-Kontos.

media sync account test <id>

screenrig media sync account test msa_01EXAMPLEACCOUNT0000000

Die Antwort wird als last_test gespeichert. Bei einer Microsoft-App meldet der Test credentials (Microsoft hat ein Token ausgestellt; eine Ablehnung trägt den AADSTS-Code, etwa AADSTS7000215 für ein Secret, das die ID statt des Werts ist) und permissions (die Graph-Anwendungsberechtigungen, die das Token trägt). Sites.Selected allein ist eine Warnung: Jede Site braucht weiterhin ihre Freigabe, und ein Freigabelink braucht Files.Read.All. Der Test beurteilt weder die Freigabe einer Site noch einen Ordner: media sync create liest den Ordner, den Sie nennen. Eine fehlgeschlagene Prüfung ist data.ok false mit Exit 0.

Löscht ein Konto, das keine Synchronisierung nutzt.

media sync account delete <id> [--expect-rev REVISION]

screenrig media sync account delete msa_01EXAMPLEACCOUNT0000000

Solange Synchronisierungen das Konto nutzen, lautet die Antwort resource_conflict (Exit 5) und nennt sie: Löschen Sie diese zuerst.

Synchronisiert einen SharePoint- oder OneDrive-for-Work-Ordner in einen Medienordner.

media sync create sharepoint --account-id ID --url URL [--folder-id ID] [--every DURATION] [--name NAME]

screenrig media sync create sharepoint --account-id msa_01EXAMPLEACCOUNT0000000 --url https://contoso.sharepoint.com/sites/Marketing/Shared%20Documents/Lobby%20Signs
screenrig media sync create sharepoint --account-id msa_01EXAMPLEACCOUNT0000000 --url "https://contoso.sharepoint.com/:f:/s/Marketing/EabcDEF" --folder-id mfd_01EXAMPLEFOLDER000000000 --every 1h --name "Lobby signs"

Ein Ordner, den Microsoft ablehnt, ist media_sync_source_refused (Exit 5), mit der zu erteilenden Berechtigung; es wird nichts gespeichert.

Synchronisiert einen Dropbox-Ordner in einen Medienordner.

media sync create dropbox --account-id ID --url URL|PATH [--folder-id ID] [--every DURATION] [--name NAME]

screenrig media sync create dropbox --account-id msa_01EXAMPLEACCOUNT0000000 --url https://www.dropbox.com/home/Marketing/Lobby%20Signs
screenrig media sync create dropbox --account-id msa_01EXAMPLEACCOUNT0000000 --url /Marketing/Lobby --folder-id mfd_01EXAMPLEFOLDER000000000 --every 1h --name "Lobby signs"

Jeder Lauf setzt an der von Dropbox gespeicherten Position im Ordner fort und liest nur, was sich geändert hat. Ein Ordner, den das Konto nicht öffnen kann, ist media_sync_source_refused, und eine Verbindung, die Dropbox nicht mehr anerkennt, ist dropbox_reconnect_required (media sync account connect): beide mit Exit 5, nichts wird gespeichert.

Synchronisiert einen Google-Drive-Ordner, der für das Dienstkonto eines Kontos freigegeben ist, in einen Medienordner.

media sync create google-drive --account-id ID --url URL|ID [--folder-id ID] [--every DURATION] [--name NAME]

screenrig media sync create google-drive --account-id msa_01EXAMPLEACCOUNT0000000 --url https://drive.google.com/drive/folders/1AbCdEfGhIjKlMnOpQrStUvWxYz --folder-id mfd_01EXAMPLEFOLDER000000000 --every 1h
screenrig media sync create google-drive --account-id msa_01EXAMPLEACCOUNT0000000 --url 1AbCdEfGhIjKlMnOpQrStUvWxYz

Über das Dienstkonto von screenRIG wird der Ordner nur synchronisiert, wenn ein Mitglied dieses Projekts mit verifizierter E-Mail ihn freigegeben hat oder besitzt (media_sync_sharer_not_member, Exit 3, nichts wird gespeichert). Jeder Lauf prüft das erneut, und ein Ordner, der einen solchen Freigeber verliert, stoppt die Synchronisierung im Zustand error, wobei ihre Medien erhalten bleiben: Geben Sie ihn erneut über das Google-Konto eines Mitglieds frei und führen Sie dann media sync update ID --resume aus. Dateien aus Google Docs, Sheets und Slides werden als unsupported_type übersprungen. Ein Ordner, den die Adresse nicht öffnen kann, ist media_sync_source_refused (Exit 5): Geben Sie ihn für das Dienstkonto frei.

Listet die Mediensynchronisierungen dieses Projekts mit Medienordner, Rhythmus, Zustand und Status des letzten Laufs auf.

media sync list

Keine Parameter.

screenrig media sync list

Zeigt eine Synchronisierung und die Zusammenfassung ihres letzten Laufs.

media sync show <id>

screenrig media sync show msy_01EXAMPLESYNC000000000

data.last_run enthält status (ok, partial oder error), added, updated, removed, pending_delete (entfernte Dateien, die ein Bildschirm noch hält und die im Ordner Removed warten), skipped_total und skipped, die ersten 20 übersprungenen Dateien mit dem Grund jeder Datei (unsupported_type, too_large, storage, subfolder, download_failed, unreadable, in_use); ein fehlgeschlagener Lauf enthält error mit einem code und einem detail, die die Behebung nennen. data.source fügt path für Dropbox und shared_by für Google Drive hinzu.

Eine Synchronisierung im Zustand error muss repariert werden. Ihr Medienordner wurde gelöscht: Richten Sie sie mit media sync update --folder-id auf einen anderen aus. Ihr Quellordner wurde gelöscht oder verschoben: Löschen Sie die Synchronisierung und legen Sie eine neue an. Bei Google Drive über das Dienstkonto von screenRIG hat der Ordner seinen verifizierten Freigeber verloren (sharer_not_member): Geben Sie ihn erneut über das Google-Konto eines Projektmitglieds frei und führen Sie dann media sync update ID --resume aus. Ein Dropbox-Lauf schlägt mit reconnect_required fehl, wenn Dropbox die Verbindung nicht mehr anerkennt (media sync account connect).

Ändert Name, Rhythmus oder Medienordner einer Synchronisierung oder pausiert und setzt sie fort.

media sync update <id> [--name NAME] [--every DURATION] [--folder-id ID]
    [--pause | --resume] [--expect-rev REVISION]

screenrig media sync update msy_01EXAMPLESYNC000000000 --every 1h
screenrig media sync update msy_01EXAMPLESYNC000000000 --pause
screenrig media sync update msy_01EXAMPLESYNC000000000 --folder-id mfd_01EXAMPLEFOLDER000000000 --expect-rev 3

Mindestens eine Änderung ist erforderlich.

Führt eine Synchronisierung jetzt statt zu ihrem nächsten Zeitpunkt aus.

media sync run <id>

screenrig media sync run msy_01EXAMPLESYNC000000000

Die Synchronisierung läuft innerhalb von etwa 30 Sekunden, und media sync show zeigt dann ihren letzten Lauf. Eine pausierte Synchronisierung muss zuerst fortgesetzt werden.

Stoppt eine Synchronisierung; ihre Medien und ihr Ordner bleiben erhalten.

media sync delete <id> [--expect-rev REVISION]

screenrig media sync delete msy_01EXAMPLESYNC000000000

Die Synchronisierung vergisst, welche Quelldatei zu welchem Medium wurde. Die importierten Medien und der Medienordner bleiben erhalten, und nichts wird entfernt.