tabcmd

Belangrijk: tabcmd 1.0 werkt niet meer met Tableau Cloud wanneer de pod waarop uw site zich bevindt, naar Hyperforce wordt verplaatst. Plan uw migratie naar tabcmd 2.0 zo snel mogelijk om te zorgen dat hiervan u geen hinder ondervindt. Zie het kennisartikel Tableau Cloud-migratie naar Hyperforce(Link wordt in een nieuw venster geopend) voor meer informatie over de migratie van Tableau Cloud naar Hyperforce. Deze stopzetting heeft geen gevolgen voor Tableau Server.

Opmerking: in de meeste gevallen moet u het opdrachtregelprogramma tabcmd 2.0 (tabcmd 2.0) gebruiken met Tableau Cloud. Tabcmd 2.0 is beschikbaar op Tableau tabcmd(Link wordt in een nieuw venster geopend). Met deze nieuwe versie kunt u: tabcmd-opdrachten uitvoeren op MacOS en Linux, verifiëren met persoonlijke toegangstokens (PAT's) en voldoen aan de vereisten voor meervoudige verificatie (MFA). Versie 2.0 is gebouwd op openbare eindpunten die beschikbaar zijn in een op Python gebaseerde Tableau Server Client (TSC).

Tableau biedt het opdrachtregelhulpprogramma tabcmd waarmee u taken voor sitebeheer kunt automatiseren voor uw Tableau Cloud-site. Bijvoorbeeld voor het maken of verwijderen van gebruikers, projecten en groepen.

Belangrijk: tabcmd 1.0 ondersteunt geen meervoudige verificatie (MFA). Om tabcmd met Tableau Cloud te gebruiken, gebruikt u Tableau tabcmd 2.0(Link wordt in een nieuw venster geopend) (nieuw venster). Zie Meervoudige verificatie en Tableau Cloud voor meer informatie over Tableau en meervoudige verificatie (MFA).

Tabcmd installeren

Opmerking: deze instructies zijn bedoeld voor het installeren van het opdrachtregelhulpprogramma tabcmd 1.0. Om het opdrachtregelhulpprogramma tabcmd 2.0 te installeren, gaat u naar Tableau tabcmd(Link wordt in een nieuw venster geopend) (nieuw venster).

Wanneer Tableau Server of Tableau Cloud wordt bijgewerkt naar een nieuwe versie, kunt u, indien een bijgewerkte versie van tabcmd vereist is, deze downloaden van de pagina Tableau Server Release op de Tableau-website.

Voor Tableau Server raden we aan de versie te downloaden die overeenkomt met uw serverversie. Voor Tableau Cloud raden we aan altijd de nieuwste versie te downloaden om problemen door incompatibele versies te voorkomen. In beide gevallen kan het gebruik van een verouderde versie van tabcmd fouten en onvoorspelbare resultaten veroorzaken.

  1. Open een webbrowser en ga naar de pagina Tableau Server Release(Link wordt in een nieuw venster geopend). Ga naar deze pagina, zelfs als u Tableau Online gebruikt.

  2. Als u het volgende gebruikt:

    In beide gevallen geldt: als de uitgebreide informatie onderhoudsreleases aangeeft, selecteert u de nieuwste onderhoudsrelease of de release die overeenkomt met uw serverversie.

    Selecteer de serverversie die u gebruikt (nieuwste versie voor Tableau Cloud)

    Hiermee gaat u naar de pagina met release-opmerkingen, genaamd Opgeloste problemen. Hier kunt u meer lezen over beveiligingsverbeteringen en opgeloste problemen.

  3. Ga naar het deel Bestanden downloaden onder Opgeloste problemen. Download hier de downloadlink voor tabcmd die compatibel is met de computer waarop u de tabcmd-opdrachten wilt uitvoeren. 

    Selecteer het tabcmd-installatieprogramma voor de computer waarop u het wilt gebruiken (32 of 64 bits)

    In de overige stappen wordt naar deze computer verwezen als ’de tabcmd-computer’

  4. Sla het installatieprogramma op de tabcmd-computer op, of op een locatie die toegankelijk is vanaf die computer .

  5. Voer de installatiestappen uit die geschikt zijn voor het besturingssysteem van de tabcmd-computer:

    • Windows
    • Linux

    Om tabcmd van een Linux-computer te verwijderen, raadpleegt u de documentatie voor de Linux-versie die u gebruikt.

  6. (Optioneel) Voeg de volledige locatie waar tabcmd is geïnstalleerd toe aan het systeempad. Zo kunt u tabcmd-opdrachten uitvoeren zonder dat u naar die locatie hoeft te gaan of de locatie bij elke opdracht hoeft op te geven. De stappen die u hiervoor moet nemen, zijn afhankelijk van het type en de versie van uw besturingssysteem. Zie PATH_(variabele) voor meer informatie.

Hoe tabcmd te gebruiken

De basisstappen voor het gebruik van tabcmd zijn als volgt:

  1. Open de opdrachtprompt als beheerder.

    Opmerking: gebruik PowerShell niet om tabcmd-opdrachten uit te voeren in Windows. Het gebruik van PowerShell kan onverwacht gedrag veroorzaken.

  2. Als u tabcmd op een Windows-computer hebt geïnstalleerd die niet het oorspronkelijke knooppunt is, gaat u naar de map waarin u tabcmd hebt geïnstalleerd.

    Op een Linux-computer hoeft u niet naar de installatiemap te gaan.

  3. Voer de opdracht tabcmd uit.

Wanneer u tabcmd gebruikt, moet u een geverifieerde serversessie tot stand brengen. De sessie identificeert de server of Tableau Cloud-site en de gebruiker die de sessie uitvoert. U kunt eerst een sessie starten en vervolgens uw opdracht opgeven, of u kunt een sessie starten en een opdracht in één keer uitvoeren.

Belangrijk: als u tabcmd gebruikt om meer dan één taak uit te voeren, moet u de taken één voor één (serieel) uitvoeren in plaats van tegelijkertijd (parallel).

Opdrachten (zoals login) en de opties (zoals -s, -u, enz.) zijn niet hoofdlettergevoelig. Maar de waarden die u opgeeft (zoals User@Example.com) zijn hoofdlettergevoelig.

Voorbeelden

De volgende opdracht laat zien hoe u een sessie start:

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

Hier ziet u hoe u een sessie start en een werkmap verwijdert met één opdracht. U hoeft login hier niet op te geven:

tabcmd delete "Sales_Workbook" -s https://prod-useast-b.online.tableau.com -t campaign -u admin@email.com -p password

De opties -s, -t, -u en -p behoren tot de algemene tabcmd-variabelen en kunnen met elke opdracht worden gebruikt.

Zie tabcmd-opdrachten voor meer informatie.