tabcmd-Befehle


Wichtig: tabcmd 1.0 funktioniert nicht mehr mit Tableau Cloud, wenn der Pod, auf dem sich Ihre Site befindet, zu Hyperforce verschoben wird. Planen Sie Ihre Migration auf tabcmd 2.0 so bald wie möglich, um sicherzustellen, dass Sie davon nicht betroffen sein werden. Weitere Informationen zur Migration von Tableau Cloud zu Hyperforce finden Sie im Knowledge-Artikel zur Tableau Cloud-Migration zu Hyperforce(Link wird in neuem Fenster geöffnet). Auf Tableau Server hat diese Außerbetriebnahme keine Auswirkungen.

Hinweis: In den meisten Fällen müssen Sie das tabcmd-Befehlszeilendienstprogramm der Version 2.0 (tabcmd 2.0) mit Tableau Cloud verwenden. Tabcmd 2.0 ist bei Tableau tabcmd(Link wird in neuem Fenster geöffnet) verfügbar. Diese neue Version ermöglicht es Ihnen, tabcmd-Befehle unter MacOS und Linux auszuführen, sich mit persönlichen Zugriffstoken (PATs) zu authentifizieren und erlaubt es Ihnen, MFA-kompatibel (Multi-Faktor-Authentifizierung) zu sein. Version 2.0 basiert auf öffentlichen Endpunkten, die im Python-basierten Tableau Server Client (TSC) verfügbar sind.

Sie können die folgenden Befehle mit dem tabcmd-Befehlszeilenprogramm in Tableau Cloud verwenden:

addusers Name-einer-Gruppe

Fügt der angegebenen Gruppe Benutzer hinzu.

Beispiel

tabcmd addusers "Development" --users "users.csv"

Optionen

--users

Fügt die Benutzer aus der angegebenen .csv-Datei der angegebenen Gruppe hinzu. Die Datei muss eine einfache Liste mit einem Benutzernamen pro Zeile sein. Bei Benutzernamen wird die Groß-/Kleinschreibung nicht beachtet. Die Benutzer sollten bereits in Tableau Cloud erstellt worden sein.

Weitere Informationen finden Sie in den Richtlinien für CSV-Importdatei.

--[no-]complete

Bei der Angabe von complete müssen alle Zeilen gültig sein, damit Änderungen erfolgreich durchgeführt werden. Wird nichts angegeben, dann wird --complete verwendet.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

createextracts

Erstellt Extrakte für eine veröffentlichte Arbeitsmappe oder Datenquelle.

Optionen

-d, --datasource

Der Name der Zieldatenquelle für die Extrakterstellung.

--embedded-datasources

Eine durch Leerzeichen getrennte Liste eingebetteter Datenquellennamen in der Zielarbeitsmappe. Schließen Sie Datenquellennamen mit doppelten Anführungszeichen ein, wenn sie Leerzeichen enthalten. Nur verfügbar beim Erstellen von Extrakten für eine Arbeitsmappe.

--encrypt

Verschlüsselten Extrakt erstellen.

--include-all

Schließen Sie alle eingebetteten Datenquellen in die Zielarbeitsmappe ein. Nur verfügbar beim Erstellen von Extrakten für eine Arbeitsmappe.

--parent-project-path

Pfad des Projekts, das das übergeordnete Element des die Zielressource enthaltenden Projekts ist. Der Projektname muss mit --project angegeben werden.

--project

Der Name des Projekts, das die Zielressource enthält. Nur erforderlich, wenn --workbook oder --datasource angegeben werden. Wenn nicht angegeben, wird das Standardprojekt 'Standard' verwendet.

-u, -url

Der kanonische Name der Ressource, wie er in der URL angezeigt wird.

-w, -workbook

Der Name der Zielarbeitsmappe für die Extrakterstellung.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

creategroup Name-einer-Gruppe

Erstellt eine Gruppe. Verwenden Sie addusers, um Benutzer hinzuzufügen, nachdem die Gruppe erstellt wurde.

Beispiel

tabcmd creategroup "Development"

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

createproject Name-eines-Projekts

Erstellt ein Projekt.

Beispiel

tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing quarterly sales reports."

Optionen

-n, --name

Legt den Namen des Projekts fest, das erstellt werden soll.

--parent-project-path

Gibt den Namen des übergeordneten Projekts für das geschachtelte Projekt an, wie mit der -n -Option angegeben. Verwenden Sie beispielsweise die folgende Syntax, --parent-project-path "Main" -n "Nested", um ein Projekt mit dem Namen "Nested" anzugeben, das in einem "Main"-Projekt vorhanden ist.

-d, --description

Legt eine Beschreibung für das Projekt fest.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

createsiteusers Dateiname.csv

Fügt Benutzer auf Grundlage der in einer CSV-Datei übermittelten Informationen zu einer Site hinzu. Wenn der Benutzer nicht bereits auf dem Server erstellt wurde, erstellt der Befehl den Benutzer, bevor der Site dieser Benutzer hinzugefügt wird.

Die CSV-Datei muss mindestens einen Benutzernamen enthalten und darüber hinaus (für jeden Benutzer) ein Kennwort, den vollständigen Namen, den Lizenztyp, die Administratorstufe, Publisher (ja/nein) und die E-Mail-Adresse. Weitere Informationen zum Format der CSV-Datei finden Sie unter Richtlinien für CSV-Importdatei.

Als Alternative zum Einbeziehen von Publisher-Berechtigungen und Berechtigungen auf Administratorebene können Sie Informationen zu den Zugriffsstufen übergeben, indem Sie die Option --role einfügen und die Site-Rolle angeben, die Sie den in der CSV-Datei aufgelisteten Benutzern zuweisen möchten.

Standardmäßig werden Benutzer zur Site hinzugefügt, bei der Sie angemeldet sind. Um Benutzer zu einer anderen Site hinzuzufügen, beziehen Sie die globale Option --site ein, und geben Sie diese Site an. (Sie müssen über entsprechende Berechtigungen verfügen, um Benutzer auf der von Ihnen angegebenen Site zu erstellen.)

Beispiel

tabcmd createsiteusers "users.csv" --role "Explorer"

Optionen

--admin-type

Veraltet. Verwenden Sie stattdessen die Option --role.

--auth-type

Legt den Authentifizierungstyp (TableauID oder SAML) für alle Benutzer in der .csv-Datei fest. Wenn keine Angabe gemacht wird, lautet die Standardeinstellung TableauID.

Hinweis: Um die SAML-Authentifizierung zu verwenden, muss die Site selbst auch SAML-fähig sein. Weitere Informationen finden Sie unter Aktivieren von SAML-Authentifizierung für eine Site.

--[no-]complete

Veraltet. Standardfehlerverhalten: Wenn es mehr als 3 Fehler innerhalb eines Bereichs von zehn Zeilen gibt, schlägt der Befehl fehl.

--no-publisher

Veraltet. Verwenden Sie stattdessen die Option --role.

--nowait

Nicht warten, bis asynchrone Aufträge abgeschlossen worden sind.

--publisher

Veraltet. Verwenden Sie stattdessen die Option --role.

--role

Gibt eine Site-spezifische Rolle für alle Benutzer in der .csv-Datei an. Wenn Sie Site-spezifische Rollen mit der Option "--role" zuweisen möchten, erstellen Sie für jede Site-spezifische Rolle eine eigene CSV-Datei.

Gültige Werte: ServerAdministrator, SiteAdministratorCreator, SiteAdministratorExplorer, SiteAdministrator, Creator, ExplorerCanPublish, Publisher, Explorer, Interactor, Viewer, and Unlicensed.

Der Standardwert für neue Benutzer lautet Unlicensed. Für bestehende Benutzer bleibt er unverändert. Benutzer werden auch dann als nicht lizenziert hinzugefügt, wenn Sie eine benutzerbasierte Serverinstallation haben und der Befehl createsiteusers einen neuen Benutzer erstellt, Sie aber die maximale Anzahl an verfügbaren Benutzerlizenzen bereits überschritten haben.

Hinweis: Wenn Sie auf einem Tableau Server mit mehreren Sites die Site-spezifische Rolle ServerAdministrator mit der Option --role zuweisen möchten, verwenden Sie den Befehl createusers anstelle von createsiteusers.

--silent-progress

Keine Fortschrittsmeldungen für den Befehl anzeigen.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

delete Name-einer-Arbeitsmappe oder Name-einer-Datenquelle

Löscht die angegebene Arbeitsmappe oder Datenquelle vom Server.

Diesem Befehl wird der auf dem Server verwendete Name der Arbeitsmappe oder der Datenquelle übergeben und nicht der Dateiname, der beim Veröffentlichen verwendet wurde.

Beispiel

tabcmd delete "Sales_Analysis"

Optionen

-r, --project

Der Name des Projekts, das die zu löschende Arbeitsmappe oder Datenquelle enthält. Sofern keine Angabe erfolgt, wird das Projekt "Standard" verwendet.

--parent-project-path

Gibt den Namen des übergeordneten Projekts für das geschachtelte Projekt an, wie mit der -r -Option angegeben. Verwenden Sie beispielsweise die folgende Syntax, --parent-project-path "Main" -r "Nested", um ein Projekt mit dem Namen "Nested" anzugeben, das in einem "Main"-Projekt vorhanden ist.

--workbook

Der Name der zu löschenden Arbeitsmappe.

--datasource

Der Name der zu löschenden Datenquelle.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

deleteextracts

Löscht Extrakte für eine veröffentlichte Arbeitsmappe oder Datenquelle.

Optionen

-d, --datasource

Der Name der Zieldatenquelle für das Löschen von Extrakten.

--embedded-datasources

Eine durch Leerzeichen getrennte Liste eingebetteter Datenquellennamen in der Zielarbeitsmappe. Schließen Sie Datenquellennamen mit doppelten Anführungszeichen ein, wenn sie Leerzeichen enthalten. Nur verfügbar beim Löschen von Extrakten für eine Arbeitsmappe.

--encrypt

Verschlüsselten Extrakt erstellen.

--include-all

Schließen Sie alle eingebetteten Datenquellen in die Zielarbeitsmappe ein.

--parent-project-path

Pfad des Projekts, das das übergeordnete Element des die Zielressource enthaltenden Projekts ist. Der Projektname muss mit --project angegeben werden.

--project

Der Name des Projekts, das die Zielressource enthält. Nur erforderlich, wenn --workbook oder --datasource angegeben werden. Wenn nicht angegeben, wird das Standardprojekt 'Standard' verwendet.

-u, -url

Der kanonische Name der Ressource, wie er in der URL angezeigt wird.

-w, -workbook

Der Name der Zielarbeitsmappe für das Löschen von Extrakten.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

deletegroup Name-einer-Gruppe

Löscht die angegebene Gruppe vom Server.

Beispiel

tabcmd deletegroup "Development"

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

deleteproject Name-eines-Projekts

Löscht das angegebene Projekt vom Server.

Mit tabcmd können Sie nur ein Projekt auf oberster Ebene in einer Projekthierarchie angeben. Verwenden Sie den entsprechenden Tableau REST API(Link wird in neuem Fenster geöffnet)-Aufruf, um die Aufgaben zu automatisieren, die Sie für ein Projekt innerhalb eines übergeordneten Projekts ausführen möchten.

Beispiel

tabcmd deleteproject "Designs"

Option

--parent-project-path

Gibt den Namen des übergeordneten Projekts für das geschachtelte Projekt an, wie mit dem Befehl angegeben. Verwenden Sie beispielsweise die folgende Syntax, --parent-project-path "Main" "Designs", um ein Projekt mit dem Namen "Designs" anzugeben, das in einem "Main"-Projekt vorhanden ist.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

deletesiteusers Dateiname.csv

Entfernt Benutzer von der Site, auf der Sie angemeldet sind. Die zu entfernenden Benutzer sind in einer Datei angegeben, die eine einfache Liste mit einem Benutzernamen pro Zeile enthält. (Neben dem Benutzernamen sind keine zusätzlichen Informationen erforderlich.)

Der Benutzer wird standardmäßig ebenfalls vom Server entfernt, wenn der Server nur über ein Site verfügt oder wenn der Benutzer nur zu einer Site gehört. Wenn der Server bei einer Tableau Server Enterprise-Installation mehrere Sites enthält, werden Benutzer, denen die Site-spezifische Rolle Serveradministrator zugewiesen ist, von der Site, aber nicht vom Server entfernt.

Wenn der Benutzer Inhaltsinhaber ist, wird die Rolle des Benutzers zu Nicht lizenziert geändert, der Benutzer wird jedoch nicht vom Server oder der Site entfernt. Der Inhalt gehört weiterhin diesem Benutzer. Um den Benutzer vollständig zu entfernen, müssen Sie den Inhaltsinhaber ändern und dann erneut versuchen, den Benutzer zu entfernen.

Beispiel

tabcmd deletesiteusers "users.csv"

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

export

Exportiert eine Ansicht oder Arbeitsmappe aus Tableau Cloud und speichert diese in einer Datei. Mit diesem Befehl können auch nur die für eine Ansicht verwendeten Daten exportiert werden. Ansichtsdaten werden auf der Zusammenfassungsebene exportiert. Zum Exportieren von Daten auf Detailebene müssen Sie die Tableau Server-Benutzeroberfläche verwenden. Weitere Informationen finden Sie unter Herunterladen von Ansichten und Arbeitsmappen(Link wird in neuem Fenster geöffnet).

Beachten Sie Folgendes bei der Verwendung dieses Befehls:

  • Berechtigungen: Zum Exportieren benötigen Sie die Berechtigung für Bild exportieren. Standardmäßig wird diese Berechtigung für alle Rollen zugelassen oder vererbt, wobei Berechtigungen auch per Arbeitsmappe oder Ansicht festgelegt werden können.

  • Exportieren von Daten: Zum ausschließlichen Exportieren der Daten für eine Ansicht verwenden Sie die Option --csv. Damit werden die in einer Ansicht verwendeten Zusammenfassungsdaten in eine CSV-Datei exportiert.

  • Angeben der zu exportierenden Ansicht, Arbeitsmappe oder Daten:

    • Verwenden Sie einen Teil der URL zur Angabe der zu exportierenden Inhalte, insbesondere die Zeichenfolge "workbook/view", wie sie in der URL für die Arbeitsmappe oder Ansicht angezeigt wird. Verwenden Sie nicht den "Anzeigenamen" und schließen Sie die Sitzungs-ID :iid=<n> am Ende der URL aus.

      Die Tableau-Beispielansicht Bestelldetails in der Arbeitsmappe Superstore hat beispielsweise eine URL, die der folgenden ähnelt: <server_name>/#/views/Superstore/OrderDetails?:iid=2

      Wenn Sie die Ansicht Bestelldetails exportieren möchten, verwenden Sie die Zeichenfolge Superstore/OrderDetails.

      Verwenden Sie nicht Superstore/Order Details oder Superstore/OrderDetails?:iid=2.

    • Verwenden Sie -t <site_id>, falls mehrere Sites auf dem Server ausgeführt werden und sich die Ansicht oder Arbeitsmappe nicht auf der Standardsite befindet.

    • Rufen Sie zum Exportieren einer Arbeitsmappe die URL-Zeichenfolge ab, indem Sie eine Ansicht in der Arbeitsmappe öffnen, und fügen Sie die Ansicht in die verwendete Zeichenfolge ein.

      Um in dem oben angegebenen Beispiel die Arbeitsmappe Superstore zu exportieren, verwenden Sie die Zeichenfolge Superstore/OrderDetails.

    • Damit eine Arbeitsmappe exportiert werden kann, muss sie mit Blätter als Registerkarten anzeigen im Dialogfeld "Veröffentlichen" von Tableau Desktop veröffentlicht worden sein.

      Hinweis: Die Tableau-Arbeitsmappe, die die Admin-Ansichten(Link wird in neuem Fenster geöffnet) enthält, kann nicht exportiert werden.

    • Fügen Sie zum Filtern der von Ihnen heruntergeladenen Daten einen Parameterfilter mit diesem Format hinzu:

      ?<filter_name>=value

      oder, wenn die Filterung nach einem Parameter erfolgt und dieser Parameter einen Anzeigenamen hat, der mit dem Namen einer Kennzahl oder Dimension übereinstimmt:

      ?Parameters.<filter_name>=value

  • Das Format der gespeicherten Datei: Die Formatoptionen sind abhängig von den zu exportierenden Daten. Eine Arbeitsmappe kann nur mit dem Argument --fullpdf als PDF exportiert werden. Eine Ansicht kann als PDF (--pdf) oder PNG (--png) exportiert werden.

  • Name und Speicherort der gespeicherten Datei (optional): Wenn Sie keinen Namen angeben, wird er aus dem Namen der Ansicht oder der Arbeitsmappe abgeleitet. Wenn Sie keinen Speicherort angeben, wird die Datei in das aktuelle Arbeitsverzeichnis gespeichert. Ansonsten können Sie einen vollständigen Pfad angeben oder auch einen Pfad relativ zum aktuellen Arbeitsverzeichnis festlegen.

    Hinweis:Sie müssen eine Dateinamenerweiterung wie .csv oder .pdf angeben. Der Befehl hängt nicht automatisch eine Dateinamenerweiterung an den angegebenen Dateinamen an.

  • Objekte von Dashboard-Webseiten, die nicht in PDF-Exporten enthalten sind: Dashboards können optional Webseitenobjekte enthalten. Wenn ein Dashboard mit einem Webseitenobjekt in eine PDF-Datei exportiert wird, ist das Webseitenobjekt nicht im PDF enthalten.

  • Nicht-ASCII- und Nicht-Standard-ASCII-Zeichen sowie PDF-Exporte: Wenn Sie eine Ansicht oder eine Arbeitsmappe exportieren, deren Name Zeichen enthält, die nicht zum ASCII-Zeichensatz gehören, oder Nicht-Standard-ASCII-Zeichen aufweist, müssen Sie eine URL-Codierung (Prozentzeichen-Codierung) des Zeichens vornehmen.

    Wenn Ihr Beispiel z. B. die Stadt Zürich enthält, müssen Sie stattdessen die URL-Codierung Z%C3%BCrich verwenden:

    tabcmd export "/Cities/Sheet1?locationCity=Z%C3%BCrich" -fullpdf

Löschen des Cache zur Verwendung von Echtzeitdaten

Sie können optional den URL-Parameter ?:refresh=yes hinzufügen, damit eine erneute Datenabfrage erfolgt und die Ergebnisse nicht aus dem Cache abgerufen werden. Wenn tabcmd mit eigenen Skripten verwendet wird und der URL-Parameter refresh häufig auftritt, kann die Leistung beeinträchtigt werden. Der Parameter refresh sollte nur verwendet werden, wenn Echtzeitdaten erforderlich sind, beispielsweise für ein einzelnes Dashboard, nicht jedoch für eine gesamte Arbeitsmappe.

Beispiele

Ansichten

tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report.csv"

tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"

tabcmd export "Finance/InvestmentGrowth" --png

tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png

Arbeitsmappen

tabcmd export "Q1Sales/Sales_Report" --fullpdf

tabcmd export "Sales/Sales_Analysis" --fullpdf --pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"

Optionen

-f, --filename

Speichert die Datei mit dem angegebenen Dateinamen und der Erweiterung.

--csv

Nur Ansicht. Exportieren Sie die Daten der Ansicht (Zusammenfassungsdaten) in das .csv-Format.

--pdf

Nur Ansicht. Export als PDF-Datei.

--png

Nur Ansicht. Export als Bild im .png-Format.

--fullpdf

Nur Arbeitsmappe. Export als PDF-Datei. Die Arbeitsmappe muss mit aktivierter Option Blätter als Registerkarten anzeigen veröffentlicht worden sein.

--pagelayout

Legt die Seitenausrichtung (landscape oder portrait) der exportierten PDF-Datei fest. Falls nichts angegeben ist, wird die Tableau Desktop-Einstellung verwendet.

--pagesize

Legt die Seitengröße der exportierten PDF-Datei auf einen der folgenden Werte fest: unspecified, letter, legal, note folio, tabloid, ledger, statement, executive, a3, a4, a5, b4, b5 oder quarto. Der Standardwert lautet letter.

--width

Legt die Breite in Pixeln fest. Der Standard ist 800 px.

--height

Legt die Höhe in Pixeln fest. Der Standard ist 600 px.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

get url

Ruft die Ressource aus Tableau Cloud ab, die durch die angegebene (partielle) URL dargestellt wird. Das Ergebnis wird als eine Datei zurückgegeben.

Beachten Sie Folgendes bei der Verwendung dieses Befehls:

  • Berechtigungen: Zum Abrufen einer Datei benötigen Sie die Berechtigung Herunterladen/Im Web speichern unter. Standardmäßig wird diese Berechtigung für alle Rollen zugelassen oder vererbt, wobei Berechtigungen auch per Arbeitsmappe oder Ansicht festgelegt werden können.

  • Angeben einer abzurufenden Ansicht oder Arbeitsmappe: Eine abzurufende Ansicht wird mithilfe der Zeichenfolge "/views/<workbookname>/<viewname>.<extension>" und eine abzurufende Arbeitsmappe mithilfe der Zeichenfolge "/workbooks/<workbookname>.<extension>"angegeben. Ersetzen Sie <workbookname>  und <viewname> durch die Namen der Arbeitsmappe und Ansichten in der URL, wenn Sie die Ansicht in einem Browser öffnen und <extension> durch den zu speichernden Dateityp ersetzen. Verwenden Sie nicht die Sitzungs-ID am Ende der URL (?:iid=<n>) oder den Anzeigenamen der Arbeitsmappe oder Ansicht.

    Wenn Sie beispielsweise die Ansicht Regionale Summen in der Arbeitsmappe Metrische Übersicht öffnen, ähnelt die URL der folgenden:

    /views/MetricsSummary_1/RegionalTotals?:iid=1

    Verwenden Sie die Zeichenfolge /views/MetricsSummary_1/RegionalTotals.<extension> zum Abrufen der Ansicht.

    Verwenden Sie die Zeichenfolge /workbooks/MetricsSummary_1.<extension> zum Abrufen der Arbeitsmappe.

    Beim Herunterladen von Arbeitsmappen und Ansichten von Tableau Cloud wird der Inhalt der .twb- oder .twbx-Datei im Klartext gespeichert. Alle Daten, einschließlich Filterwerte, die semantische Hinweise auf die Daten geben können, sind für jeden lesbar, der die Datei öffnet.

  • Dateierweiterung: Die URL muss eine Dateierweiterung enthalten. Die Erweiterung bestimmt, was zurückgegeben wird. Eine Ansicht kann im Format PDF, PNG oder CSV (nur Zusammenfassungsdaten) zurückgegeben werden. Eine Tableau-Arbeitsmappe wird als TWB-Datei zurückgegeben, wenn eine Verbindung zu einer veröffentlichten Datenquelle hergestellt wurde oder eine Direktverbindung verwendet wird oder als TWBX-Datei, wenn eine Verbindung zu einem Datenextrakt hergestellt wurde.

    Anmerkung: Wenn Sie eine Ansicht in eine PDF- oder PNG-Datei herunterladen und dabei den Parameter --filename mit der Dateinamenerweiterung .pdf oder .png anhängen, müssen Sie die Dateinamenerweiterung .pdf oder .png nicht mehr in der URL angeben.

  • Name und Speicherort der gespeicherten Datei (optional): Der Name, den Sie für --filename verwenden, sollte die Dateierweiterung umfassen. Wenn Sie keinen Namen und keine Dateierweiterung angeben, werden diese aus der URL-Zeichenfolge abgeleitet. Wenn Sie keinen Speicherort angeben, wird die Datei im aktuellen Arbeitsverzeichnis gespeichert. Ansonsten können Sie einen vollständigen Pfad angeben oder auch einen Pfad relativ zum aktuellen Arbeitsverzeichnis festlegen.

  • PNG-Größe (optional): Wenn es sich bei der gespeicherten Datei um eine PNG-Datei handelt, können Sie die Größe in Pixeln in der URL angeben.

Löschen des Cache zur Verwendung von Echtzeitdaten

Sie können optional den URL-Parameter ?:refresh=yes hinzufügen, damit eine erneute Datenabfrage erfolgt und die Ergebnisse nicht aus dem Cache abgerufen werden. Wenn Sie tabcmd mit eigenen Skripten verwenden und der Parameter refresh häufig auftritt, kann die Leistung beeinträchtigt werden. Der Parameter refresh sollte nur verwendet werden, wenn Echtzeitdaten erforderlich sind, beispielsweise für ein einzelnes Dashboard, nicht jedoch für eine gesamte Arbeitsmappe.

Beispiele

Ansichten

tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename "Weekly-Report.png"

tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f "Q1Growth.pdf"

tabcmd get "/views/Finance/InvestmentGrowth" -f "Q1Growth.pdf"

tabcmd get "/views/Finance/InvestmentGrowth.csv"

tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f growth.png

tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f growth.png

Arbeitsmappen

tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_Workbooks\Weekly-Reports.twb"

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

login

Wichtig: tabcmd 1.0 unterstützt keine Multi-Faktor-Authentifizierung (MFA). Um tabcmd mit Tableau Cloud zu verwenden, verwenden Sie Tableau tabcmd 2.0(Link wird in neuem Fenster geöffnet) (neues Fenster). Weitere Informationen zu Tableau mit MFA finden Sie unter Multi-Faktor-Authentifizierung und Tableau Cloud.

Meldet einen Tableau Cloud-Benutzer an.

Verwenden Sie die globalen Optionen --server, --site, --username, --password, um eine Sitzung zu erstellen.

Anmerkung: Wenn Sie den Befehl tabcmd login verwenden, können Sie SAML-Single Sign-on (einmaliges Anmelden, SSO) nicht verwenden, selbst wenn die Site für die Verwendung von SAML konfiguriert ist. Um sich anzumelden, müssen Sie den Benutzernamen und das Kennwort eines Benutzers übergeben, der in Ihrer Site angelegt wurde. Sie werden über die Berechtigungen des Tableau Cloud-Benutzers verfügen, als der Sie angemeldet sind.

Wenn Sie sich mit den gleichen Daten anmelden möchten, die Sie bereits zum Erstellen einer Sitzung verwendet haben, geben Sie nur die Option --password an. Der Server und der Benutzername, die im Cookie gespeichert wurden, werden verwendet.

Wenn der Server einen anderen Port als 80 (dies ist der Standardwert) verwendet, müssen Sie den Port angeben.

Sie benötigen die Option --site (-t) nur, wenn auf dem Server mehrere Sites ausgeführt werden, und Sie sich bei einer anderen Site anmelden als bei der Standardsite. Wenn Sie kein Kennwort angeben, werden Sie zur Kennworteingabe aufgefordert. Wenn die Option --no-prompt angegeben und kein Kennwort bereitgestellt wird, schlägt der Befehl fehl.

Nach der Anmeldung wird die Sitzung fortgesetzt, bis sie auf dem Server abläuft oder der Befehl logout ausgeführt wird.

Beispiel

Melden Sie sich bei der Tableau Cloud-Site mit der angegebenen Site-ID an:

tabcmd login -s https://prod-useast-b.online.tableau.com -t siteID -u user@email.com -p password

Optionen

-s, --server

Wenn Sie den Befehl über einen Tableau Server-Computer ausführen, der sich in Ihrem Netzwerk befindet, können Sie http://localhost verwenden. Geben Sie andernfalls die URL des Computers an, beispielsweise http://bigbox.myco.com oder http://bigbox.

Wenn der Server SSL verwendet, müssen Sie https:// in der URL des Computers angeben.

Für Tableau Cloud geben Sie die vollständige URL einschließlich des Pods an, in dem Ihre Site bereitgestellt wird. Beispiel: https://prod-useast-b.online.tableau.com.

-t, --site

Verwenden Sie diese Option, wenn auf dem Server mehrere Sites ausgeführt werden und Sie sich auf einer anderen Site anmelden als auf der Standardsite.

Die Site-ID wird in der URL zur eindeutigen Identifizierung der Site verwendet. Eine Site mit dem Namen West Coast Sales (Umsatzdaten der Region West Coast) kann die Site-ID west-coast-sales haben.

-u, --username

Der Benutzername des Benutzers, der sich anmeldet. Für Tableau Cloud entspricht der Benutzername der E-Mail-Adresse des Benutzers.

-p, --password

Das Kennwort für den mittels --username angegebenen Benutzer. Wenn Sie kein Kennwort angeben, werden Sie zur Kennworteingabe aufgefordert.

--password-file

Lässt zu, dass das Kennwort in der angegebenen filename.txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-x, --proxy

Hiermit geben Sie den HTTP-Proxy-Server und Port (Host:Port) für die tabcmd-Abfrage an.

--no-prompt

Nicht nach einem Kennwort fragen. Wenn kein gültiges Kennwort festgelegt wird, schlägt der Befehl login fehl.

--cookie

Speichert die Sitzungs-ID bei der Anmeldung. Bei darauffolgenden Befehlen ist keine Anmeldung erforderlich. Dieser Wert ist die Standardeinstellung für den Befehl.

--no-cookie

Nehmen Sie keine Speicherung der Sitzungs-ID-Informationen nach erfolgreicher Anmeldung vor. Bei darauffolgenden Befehlen ist eine Anmeldung erforderlich.

--timeout SECONDS

Die Anzahl von Sekunden, die der Server vor Verarbeitung des Befehls login abwartet. Standard: 30 Sekunden.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

logout

Führt eine Abmeldung vom Server durch.

Beispiel

tabcmd logout

publish Dateiname.twb(x), Dateiname.tds(x) oder Dateiname.hyper

Veröffentlicht die angegebene Arbeitsmappe (.twb(x)) bzw. Datenquelle (.tds(x)) oder den Extrakt (.hyper) in Tableau Cloud.

Beim Veröffentlichen einer Arbeitsmappe werden standardmäßig alle Blätter in der Arbeitsmappe ohne Datenbankbenutzernamen oder -kennwörter veröffentlicht.

Die Berechtigungen, die der Arbeitsmappe oder Datenquelle anfangs zugewiesen wurden, werden vom Projekt kopiert, in das die Datei kopiert wird. Berechtigungen für die veröffentlichte Ressource können geändert werden, nachdem die Datei veröffentlicht wurde. 

Wenn die Arbeitsmappe Benutzerfilter enthält, muss eine der Miniaturansichtsoptionen angegeben werden.

Beispiel

tabcmd publish "analysis_sfdc.hyper" -n "Sales Analysis"
--oauth-username "user-name" --save-oauth

Wenn sich die Datei nicht im gleichen Verzeichnis wie tabcmd befindet, geben Sie den vollständigen Pfad zur Datei ein.

Beispiel

tabcmd publish "\\computer\volume\Tableau Workbooks\analysis_sfdc.hyper" -n "Sales Analysis" --oauth-username "username" --save-oauth

Optionen

-n, --name

Name der Arbeitsmappe oder Datenquelle auf dem Server. Wenn diese Option nicht angegeben wird, wird die Arbeitsmappe bzw. Datenquelle oder der Datenextrakt nach dem Dateinamen benannt.

-o, --overwrite

Überschreibt die Arbeitsmappe bzw. Datenquelle oder den Datenextrakt, wenn er bereits auf dem Server vorhanden ist.

-r, --project

Veröffentlicht die Arbeitsmappe bzw. Datenquelle oder den Datenextrakt im angegebenen Projekt. Wenn kein Projekt angegeben wird, erfolgt die Veröffentlichung im Projekt "Standard".

--parent-project-path

Gibt den Namen des übergeordneten Projekts für das geschachtelte Projekt an, wie mit der -r -Option angegeben. Verwenden Sie beispielsweise die folgende Syntax, --parent-project-path "Main" -r "Nested", um ein Projekt mit dem Namen "Nested" anzugeben, das in einem "Main"-Projekt vorhanden ist.

--db-username

Verwenden Sie diese Option, um einen Datenbankbenutzernamen mit der Arbeitsmappe bzw. Datenquelle oder dem Datenextrakt zu veröffentlichen.

Wenn Sie die Daten über eine geschützte OAuth-Verbindung und ein Zugangstoken verbinden, verwenden Sie stattdessen die Option--oauth-username.

--db-password

Verwenden Sie diese Option, um ein Datenbankkennwort mit der Arbeitsmappe bzw. Datenquelle oder dem Extrakt zu veröffentlichen.

--save-db-password

Speichert das angegebene Datenbankkennwort auf dem Server.

--oauth-username

E-Mail-Adresse des Benutzerkontos Verbindet den Benutzer über eine vorkonfigurierte OAuth-Verbindung, falls der Benutzer bereits über ein gespeichertes Zugangstoken für die in --name angegebene Cloud-Datenquelle verfügt. Zugangstoken werden in den Benutzereinstellungen verwaltet.

Verwenden Sie für vorhandene OAuth-Verbindungen zur Datenquelle diese Option anstelle von --db-username und --db-password.

--save-oauth

Speichert die durch --oauth-username angegebenen Anmeldeinformationen als eingebettete Anmeldeinformationen mit der veröffentlichten Arbeitsmappe oder Datenquelle.

Wenn der Publisher oder Serveradministrator sich beim Server anmeldet und die Verbindung für diese Arbeitsmappe oder Datenquelle bearbeitet, werden in den Verbindungseinstellungen diese OAuth-Anmeldeinformationen als in den Inhalt eingebettet angezeigt.

Wenn Sie nach der Veröffentlichung Extraktaktualisierungen planen, müssen Sie diese Option mit --oauth-username einbeziehen. Das entspricht der Verwendung von --save-db-password bei einer herkömmlichen Datenbankverbindung.

--thumbnail-username

Wenn die Arbeitsmappe Benutzerfilter enthält, wird die Miniaturansicht auf der Grundlage der für den angegebenen Benutzer geltenden Filterkriterien generiert. Kann nicht zusammen mit der Option --thumbnail-group angegeben werden.

--thumbnail-group

Wenn die Arbeitsmappe Benutzerfilter enthält, wird die Miniaturansicht auf der Grundlage der für die angegebene Gruppe geltenden Filterkriterien generiert. Kann nicht zusammen mit der Option --thumbnail-username angegeben werden.

--tabbed

Wenn eine Arbeitsmappe mit Ansichten mit Registerkarten veröffentlicht wird, wird jedes Blatt zu einer Registerkarte, mit deren Hilfe Betrachter durch die Arbeitsmappe navigieren können. Beachten Sie, dass diese Einstellungen alle Sicherheitseinstellungen auf Blattebene außer Kraft setzt.

--append

Die Extraktdatei wird der vorhandenen Datenquelle angehängt.

--replace

Die vorhandene Datenquelle wird durch die Extraktdatei ersetzt.

--disable-uploader

Der inkrementelle Datei-Uploader wird deaktiviert.

--restart

Die Datei wird erneut hochgeladen.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

refreshextracts Name-einer-Arbeitsmappe oder Name-einer-Datenquelle

Führt eine vollständige oder eine inkrementelle Aktualisierung der Extrakte durch, die der angegebenen Arbeitsmappe oder Datenquelle zugeordnet sind.

Diesem Befehl wird der auf dem Server verwendete Name der Arbeitsmappe oder der Datenquelle übergeben und nicht der Dateiname, der beim Veröffentlichen verwendet wurde. Dieser Vorgang darf nur von einem Administrator oder dem Eigentümer der Arbeitsmappe oder der Datenquelle ausgeführt werden.

Hinweise: 

Beispiele

tabcmd refreshextracts --datasource sales_ds

tabcmd refreshextracts --project "Sales External" --datasource sales_ds

tabcmd refreshextracts --project "Sales External" --parent-project-path "Main" --project "Sales External" --datasource sales_ds

tabcmd refreshextracts --workbook "My Workbook"

tabcmd refreshextracts --url SalesAnalysis

tabcmd refreshextracts --workbook "My Workbook" --addcalculations

tabcmd refreshextracts --datasource sales_ds --removecalculations

Optionen

--incremental

Führt den inkrementellen Aktualisierungsvorgang aus.

--synchronous

Fügt den vollständigen Aktualisierungsvorgang an die vom Hintergrundprozesskomponenten-Prozess verwendete Warteschlange an. Wird ausgeführt, sobald der Hintergrundprozesskomponenten-Prozess verfügbar ist. Wenn ein Hintergrundprozesskomponenten-Prozess verfügbar ist, wird der Vorgang unverzüglich ausgeführt. Der Aktualisierungsvorgang wird im Bericht für die Hintergrundaufgaben angezeigt.

Während einer synchronen Aktualisierung hält tabcmd eine aktive Verbindung mit dem Server aufrecht, solange der Aktualisierungsvorgang im Gange ist. Es erfolgt alle Sekunde eine Abfrage, bis die Hintergrundaufgabe beendet ist.

Hinweis: Die Option --synchronous ist für Datenquellen, die mit Tableau Bridge aktualisiert werden, nicht verfügbar.

--workbook

Der Name der Arbeitsmappe, die zu aktualisierende Extrakte enthält. Wenn der Name der Arbeitsmappe Leerzeichen enthält, muss er in Anführungszeichen eingeschlossen werden.

--datasource

Der Name der Datenquelle, die zu aktualisierende Extrakte enthält.

--project

Verwenden Sie diesen gemeinsam mit --workbook oder --datasource, um eine Arbeitsmappe oder Datenquelle in einem Projekt zu identifizieren, bei dem es sich nicht um das Projekt Standard handelt. Sofern keine Angabe erfolgt, wird das Projekt "Standard" verwendet.

--parent-project-path

Gibt den Namen des übergeordneten Projekts für das geschachtelte Projekt an, wie mit der --project -Option angegeben.

Beispiel:

  • Verwenden Sie die folgende Syntax, um ein Projekt mit dem Namen "Nested" anzugeben, das in einem "Main"-Projekt vorhanden ist:
  • --parent-project-path "Main" --project "Nested"
  • So geben Sie ein Projekt namens "Nested2" an, das im Projekt "Nested" verschachtelt ist: 
  • --parent-project-path "Main/Nested" --project "Nested2"

--url

Der Name der Arbeitsmappe, der in der URL angezeigt wird. Eine als "Sales Analysis" veröffentlichte Arbeitsmappe hat den URL-Namen "SalesAnalysis".

--addcalculations

Verwenden Sie diesen Befehl in Kombination mit --workbook, um Berechnungen im eingebetteten Extrakt der Arbeitsmappe zu materialisieren, oder --datasource, um Berechnungen in der Extraktdatenquelle zu materialisieren. Fügt den Vorgang der Warteschlange hinzu, der vom Prozess der Hintergrundprozesskomponente verwendet wird. Wenn ein Hintergrundprozesskomponenten-Prozess verfügbar ist, wird der Vorgang unverzüglich ausgeführt. Dieser Vorgang wird in der Verwaltungsansicht Hintergrundaufgaben für Extrakte angezeigt.

--removecalculations

Verwenden Sie diesen Befehl in Kombination mit --workbook oder --datasource, um zuvor materialisierte Berechnungen zu entfernen. Fügt den Vorgang der Warteschlange hinzu, der vom Prozess der Hintergrundprozesskomponente verwendet wird. Wenn ein Hintergrundprozesskomponenten-Prozess verfügbar ist, wird der Vorgang unverzüglich ausgeführt. Dieser Vorgang wird in der Verwaltungsansicht Hintergrundaufgaben für Extrakte angezeigt.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

removeusers Name-einer-Gruppe

Entfernt Benutzer aus der angegebenen Gruppe.

Beispiel

tabcmd removeusers "Development" --users "users.csv"

Optionen

--users

Entfernt die Benutzer in der gegebenen .csv-Datei aus der angegebenen Gruppe. Die Datei muss eine einfache Liste mit einem Benutzernamen pro Zeile sein.

--[no-]complete

Änderungen werden nur dann erfolgreich durchgeführt, wenn alle Zeilen gültig sind. Wird nichts angegeben, dann wird --complete verwendet.

Globale Optionen

Die folgenden Optionen werden von allen tabcmd-Befehlen verwendet. Die Optionen --server, --user und --password müssen mindestens einmal am Anfang einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet wurden, gültig.

-h, --help

Zeigt den Hilfetext für den Befehl an.

Hinweis: Einige aufgeführte Befehle gelten möglicherweise nicht, wenn tabcmd mit Tableau Cloud verwendet wird.

-s, --server

Die Tableau Cloud-URL, die mindestens einmal zum Starten einer Sitzung erforderlich ist.

-u, --user

Der Tableau Cloud-Benutzername, der mindestens einmal zum Starten einer Sitzung erforderlich ist.

-p, --password

Das Tableau Cloud-Kennwort, das mindestens einmal zum Starten einer Sitzung erforderlich ist.

--password-file

Lässt zu, dass das Kennwort in der angegebenen .txt-Datei statt in der Befehlszeile gespeichert wird, und erhöht damit die Sicherheit.

-t, --site

Gibt an, dass der Befehl für die durch die Tableau Cloud-Site-ID angegebene Site gilt, eingeschlossen von einfachen oder doppelten Anführungszeichen. Verwenden Sie diese Option, wenn der angegebene Benutzer mehreren Sites zugeordnet ist. Bei der Site-ID wird bei der Verwendung eines zwischengespeicherten Authentifizierungstokens die Groß- und Kleinschreibung beachtet. Wenn Sie nicht übereinstimmen, kann es sein, dass Sie zur Eingabe eines Kennworts aufgefordert werden, auch wenn das Token noch gültig ist.

--no-prompt

Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines Kennworts auf. Wenn kein gültiges Kennwort bereitgestellt wird, dann schlägt der Befehl fehl.

--[no-]cookie

Wenn diese Option angegeben wird, wird die Sitzungs-ID beim Anmelden gespeichert, sodass für nachfolgende Befehle keine Anmeldung erforderlich ist. Verwenden Sie das Präfix no-, wenn die Sitzungs-ID nicht gespeichert werden soll. Standardmäßig wird die Sitzung gespeichert.

--timeout

Wartet die angegebene Anzahl von Sekunden darauf, dass der Server die Befehlsverarbeitung abschließt. Standardmäßig wartet der Prozess, bis der Server antwortet.

--

Kennzeichnet das Ende der Optionseingabe in der Befehlszeile. Mit -- legen Sie tabcmd gegenüber fest, dass alle Angaben nach -- nicht als Optionseinstellung interpretiert werden sollen, sondern als Wert für den Befehl. So können Sie auch Werte mit Bindestrich im Befehl angeben. Das nachfolgende Beispiel zeigt, wie Sie -- in einem Befehl tabcmd verwenden, wobei -430105/Sheet1 ein erforderlicher Wert für den Befehl export ist.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

Tipp: Informationen zu den für Tableau Server verfügbaren Tabcmd 1.0-Befehlen finden Sie unter tabcmd-Befehle(Link wird in neuem Fenster geöffnet).
Zurück zum Anfang
Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.