Commandes tabcmd

Remarque : L’utilitaire de ligne de commande tabcmd version 2.0 est disponible sur Tableau tabcmd(Le lien s’ouvre dans une nouvelle fenêtre). Cette nouvelle version vous permet d’exécuter des commandes tabcmd sur MacOS et Linux et de vous authentifier à l’aide de jetons d’accès personnels (PAT). La version 2.0 est basée sur des points de terminaison publics disponibles dans Tableau Server Client (TSC) basé sur Python. Cette dernière version offre une prise en charge limitée pour Tableau Server.

Vous pouvez utiliser les commandes suivantes avec l’outil de ligne de commande tabcmd :

addusers nom-groupe

Ajoute des utilisateurs au groupe spécifié.

Exemple

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

Options

--users

Ajoutez les utilisateurs du fichier .csv donné au groupe spécifié. Le fichier doit se composer d’une liste simple avec un nom d’utilisateur par ligne. Les noms d’utilisateur ne sont pas sensibles à la casse. Les utilisateurs devraient déjà avoir été créés sur Tableau Server.

Pour plus d’informations, consultez Recommandations relatives au fichier d’importation CSV.

--[no-]complete

Lorsqu’elle est définie sur complete, cette option requiert que toutes les lignes soient valides pour que les modifications prennent effet. Sinon, --complete est utilisé.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

createextracts

Créer des extraits pour un classeur ou une source de données publié(e).

Options

-d, --datasource

Nom de la source de données cible pour la création de l’extrait.

--embedded-datasources

Liste de valeurs séparées par un espace des noms des sources de données intégrées dans le classeur cible. Entourez les noms des sources de données entre guillemets doubles s’ils contiennent des espaces. Disponible uniquement lors de la création d’extraits pour un classeur.

--encrypt

Créer un extrait crypté.

--include-all

Inclure toutes les sources de données intégrées dans le classeur cible. Disponible uniquement lors de la création d’extraits pour le classeur.

--parent-project-path

Chemin du projet qui est le parent du projet contenant la ressource cible. Vous devez spécifier le nom du projet avec --project.

--project

Nom du projet contenant la ressource cible. Nécessaire uniquement si --workbook ou --datasource est spécifié. Si non spécifié, le projet par défaut « Default » est utilisé.

-u, -url

Nom canonique du classeur tel qu’il apparaît dans l’URL.

-w, -workbook

Nom du classeur cible pour la création de l’extrait.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

creategroup nom_groupe

Crée un groupe. Utilisez la commande addusers (pour les groupes locaux) pour ajouter des utilisateurs après la création du groupe. Utilisez syncgroup (pour les groupes Active Directory) pour créer et synchroniser un groupe Tableau Server avec un groupe Active Directory.

Exemple

tabcmd creategroup "Development"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

createproject nom_projet

Crée un projet.

Exemple

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

Options

-n, --name

Spécifie le nom du projet que vous souhaitez créer.

--parent-project-path

Indique le nom du projet parent pour le projet imbriqué tel que spécifié avec l’option -n. Par exemple, pour spécifier un projet appelé « Nested » existant dans un projet « Main », utilisez la syntaxe suivante : --parent-project-path "Main" -n "Nested".

-d, --description

Spécifie une description pour le projet.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

createsite nom_site

Crée un site.

Exemples

Créez un site nommé Ventes de la côte ouest. Cela entraîne la création automatique d’un ID de site de WestCoastSales, un espace de stockage illimité pour le site, et la possibilité pour les administrateurs d’ajouter et de supprimer des utilisateurs :

tabcmd createsite "West Coast Sales"

Créez un site nommé West Coast Salesavec un ID de site de wsales :

tabcmd createsite "West Coast Sales" -r "wsales"

Empêchez les administrateurs du site d’y ajouter des utilisateurs :

tabcmd createsite "West Coast Sales" --no-site-mode

Définissez un quota de stockage, en Mo :

tabcmd createsite "West Coast Sales" --storage-quota 100

Options

-r, --url

Utilisé dans les URL pour spécifier le site. Différent du nom du site.

--user-quota

Nombre maximum d’utilisateurs pouvant être ajoutés au site.

--[no-]site-mode

Autorise ou refuse le droit aux administrateurs de site d’ajouter des utilisateurs au site ou d’en supprimer.

--storage-quota

En Mo, le volume de classeurs, extraits et sources de données pouvant être stockés sur le site.

--extract-encryption-mode

Le mode de cryptage d’extrait pour le site peut être forcé, activé ou désactivé. Pour plus d’informations, voir Cryptage d’extrait au repos.

--run-now-enabled

Autorisez ou non les utilisateurs à exécuter manuellement des actualisations d’extraits, des flux ou des planifications. true pour autoriser les utilisateurs à exécuter des tâches manuellement ou false pour empêcher les utilisateurs d’exécuter des tâches manuellement. Pour plus d’informations, consultez Paramètres du serveur (Général et Personnalisation).

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

createsiteusers nomfichier.csv

Ajoute des utilisateurs à un site, en fonction des informations fournies dans un champ avec des valeurs séparées pa une virgule (CSV). Si l’utilisateur n’est pas déjà créé sur le serveur, la commande crée l’utilisateur avant de l’ajouter au site.

Le fichier CSV doit comporter un ou plusieurs noms d’utilisateur et peut également inclure (pour chaque utilisateur) un mot de passe, un nom complet, un type de licence, un niveau Administrateur, un publicateur (oui/non) et une adresse e-mail. Pour plus d’informations sur le format du fichier CSV, voir Recommandations relatives au fichier d’importation CSV.

Comme alternative à l’inclusion du niveau Administrateur et des autorisations de publicateur dans le fichier CSV, vous pouvez transmettre les informations de niveau d’accès en incluant l’option --role et en spécifiant le rôle sur le site que vous souhaitez affecter aux utilisateurs répertoriés dans le fichier CSV.

Par défaut, les utilisateurs sont ajoutés au site auquel vous êtes connecté. Pour ajouter des utilisateurs à un site différent, incluez l’option --site gloable et spécifiez ce site. (Vous devez avoir les autorisations pour créer des utilisateurs sur le site que vous spécifiez.)

Si le serveur contient plusieurs sites, vous ne pouvez pas ajouter les administrateurs de serveur (système) via la commande createsiteusers. Utilisez createusers à la place. Si vous spécifiez le rôle sur le site ServerAdministrator pour l’option --role, la commande renvoie une erreur. Si le fichier CSV comprend System en tant que valeur pour l’administrateur, la valeur est ignorée et le type de licence Unlicensed est attribué à l’utilisateur.

Si le serveur contient un seul site (le site par défaut), vous pouvez spécifier system pour la valeur administrateur pour un utilisateur, ou même affecter le rôle sur le site ServerAdministrator à l’aide de l’option --role si vous souhaitez que tous les utilisateurs figurant dans le fichier CSV soient des administrateurs de serveur.

Par défaut, cette commande crée des utilisateurs avec une opération synchrone (elle attend que la fin de toutes les opérations avant de procéder). Vous pouvez utiliser l’option --no-waitpour spécifier une opération asynchrone.

Authentification locale

Si le serveur est configuré pour utiliser l’authentification locale, les informations du fichier CSV sont utilisées pour créer des utilisateurs.

Authentification Active Directory

Si le serveur est configuré pour utiliser l’authentification Active Directory, les informations sur l’utilisateur sont importées à partir d’Active Directory, et les informations de mot de passe et nom convivial contenues dans le fichier CSV sont ignorées. De plus, si un utilisateur est indiqué dans le fichier CSV mais qu’il n’existe aucun utilisateur correspondant dans Active Directory, l’utilisateur n’est pas ajouté à Tableau Server. Pour les utilisateurs Active Directory, le nom d’utilisateur n’étant pas garanti comme étant unique à travers les domaines, vous devez inclure le domaine comme faisant partie du nom d’utilisateur. Vous pouvez le spécifier sous la forme domain\username ou username@domain.com. Nous vous recommandons toutefois d’utiliser le format domain\username. Pour plus d’informations, consultez Gestion des utilisateurs dans les déploiements avec magasins d’identités externes.

Exemple

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

Options

--admin-type

Obsolète. À la place, utilisez l’option --role.

--auth-type

Définit le type d’authentification (Local ou SAML) pour tous les utilisateurs dans le fichier .csv. En l’absence de spécification, le paramètre par défaut est Local.

Remarque : pour utiliser l’authentification SAML, le site doit être configuré pour SAML spécifique au site dans les paramètres Tableau Server. Pour plus d’informations, consultez Configurer le protocole SAML spécifique à un site.

--[no-]complete

Obsolète. Comportement d’erreur par défaut : s’il y a plus de 3 erreurs dans une séquence de dix lignes, la commande échoue.

--no-publisher

Obsolète. À la place, utilisez l’option --role.

--nowait

Ne pas attendre que les travaux asynchrones soient terminés.

--publisher

Obsolète. À la place, utilisez l’option --role.

--role

Spécifie un rôle sur le site pour tous les utilisateurs du fichier .csv. Lorsque vous souhaitez attribuer des rôles sur le site à l’aide de l’option --role, créez un fichier CSV séparé pour chaque rôle sur le site.

Les valeurs valides sont : ServerAdministrator, SiteAdministratorCreator, SiteAdministratorExplorer, SiteAdministrator, Creator, ExplorerCanPublish, Publisher, Explorer, Interactor, Viewer, and Unlicensed.

Pour les nouveaux utilisateurs, la valeur par défaut est Unlicensed et pour les utilisateurs existants, elle reste inchangée. Les utilisateurs sont ajoutés en tant qu’utilisateurs sans licence également si votre installation de serveur est basée sur les utilisateurs et que la commande createsiteusers crée un nouvel utilisateur mais que vous avez déjà atteint la limite de nombre de licences pour vos utilisateurs.

Remarque : sur Tableau Server multisite, si vous souhaitez attribuer le rôle sur le site ServerAdministrator à l’aide de l’option --role, utilisez plutôt la commande createusers au lieu de createsiteusers.

--silent-progress

Ne pas afficher les messages de progression pour la commande.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

createusers nomfichier.csv

Créez des utilisateurs dans Tableau Server, basés sur les informations fournies dans un fichier de valeurs séparées par une virgule (CSV).

Le fichier CSV doit comporter un ou plusieurs noms d’utilisateur et peut également inclure (pour chaque utilisateur) un mot de passe, un nom complet, un type de licence, un niveau Administrateur, un publicateur (oui/non) et une adresse e-mail. Pour plus d’informations sur le format du fichier CSV, voir Recommandations relatives au fichier d’importation CSV.

Comme alternative à l’inclusion du niveau Administrateur et des autorisations de publicateur dans le fichier CSV, vous pouvez transmettre les informations de niveau d’accès en incluant l’option --role et en spécifiant le rôle sur le site que vous souhaitez affecter aux utilisateurs répertoriés dans le fichier CSV.

Si le serveur contient un seul site (le site par défaut), l’utilisateur est créé et ajouté au site. Si le serveur contient plusieurs sites, l’utilisateur est créé mais n’est ajouté à aucun site. Pour ajouter des utilisateurs à un site différent, utilisez createsiteusers.

Si votre installation de serveur est basée sur l’utilisateur et que la commande crée un nouvel utilisateur mais que vous avez déjà atteint la limite sur le nombre de licences pour vos utilisateurs, l’utilisateur est ajouté en tant qu’utilisateur sans licence.

Authentification locale

Si le serveur est configuré pour utiliser l’authentification locale, les informations du fichier CSV sont utilisées pour créer des utilisateurs.

Authentification Active Directory

Si le serveur est configuré pour utiliser l’authentification Active Directory, les informations sur l’utilisateur sont importées à partir d’Active Directory, et les informations de mot de passe et nom convivial contenues dans le fichier CSV sont ignorées. De plus, si un utilisateur est indiqué dans le fichier CSV mais qu’il n’existe aucun utilisateur correspondant dans Active Directory, l’utilisateur n’est pas ajouté à Tableau Server. Pour les utilisateurs Active Directory, le nom d’utilisateur n’étant pas garanti comme étant unique à travers les domaines, vous devez inclure le domaine comme faisant partie du nom d’utilisateur. Vous pouvez le spécifier sous la forme domain\username ou username@domain.com. Nous vous recommandons toutefois d’utiliser le format domain\username. Pour plus d’informations, consultez Gestion des utilisateurs dans les déploiements avec magasins d’identités externes.

Exemple

tabcmd createusers "users.csv" --role "ServerAdministrator"

tabcmd createusers "users.csv"

Options

--admin-type

Obsolète. À la place, utilisez l’option --role.

--[no-]complete

Obsolète. Comportement d’erreur par défaut : s’il y a plus de 3 erreurs dans une séquence de dix lignes, la commande échoue.

--no-publisher

Obsolète. À la place, utilisez l’option --role.

--nowait

Ne pas attendre que les travaux asynchrones soient terminés.

--publisher

Obsolète. À la place, utilisez l’option --role.

-r, --role

Spécifie un rôle sur le site pour tous les utilisateurs du fichier .csv. Lorsque vous souhaitez attribuer des rôles sur le site à l’aide de l’option --role, créez un fichier CSV séparé pour chaque rôle sur le site.

Les valeurs valides sont : ServerAdministrator, SiteAdministratorCreator, SiteAdministratorExplorer, SiteAdministrator, Creator, ExplorerCanPublish, Publisher, Explorer, Interactor, Viewer, and Unlicensed.

Sur un serveur multisite, la commande n’attribue pas l’utilisateur à un site. Par conséquent, les seuls rôles sur le site que la commande peut attribuer avec succès sont ServerAdministrator et Unlicensed. Si vous spécifiez un autre rôle sur le site, la commande affecte le rôle Unlicensed.

Sur un serveur de site unique, l’utilisateur est créé et ajouté au site par défaut à l’aide du rôle que vous spécifiez.

Si votre installation de serveur est basée sur l’utilisateur et que la commande crée un nouvel utilisateur mais que vous avez déjà atteint la limite sur le nombre de licences pour vos utilisateurs, l’utilisateur est ajouté en tant qu’utilisateur sans licence.

--silent-progress

Ne pas afficher les messages de progression pour la commande.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

decryptextracts

Décrypte tous les extraits d’un site. Si aucun site n’est spécifié, les extraits du site par défaut seront décryptés. Pour plus d’informations, voir Cryptage d’extrait au repos.

Selon le nombre et la taille des extraits, cette opération peut consommer des ressources serveur importantes. Envisagez d’exécuter cette commande en dehors des heures ouvrables normales.

Exemple

tabcmd decryptextracts "West Coast Sales"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

delete workbook-name ou datasource-name

Supprime le classeur ou la source de données spécifié(e) du serveur.

Cette commande utilise le nom du classeur ou de la source de données tel qu’il est spécifié sur le serveur, et non le nom du fichier lors de sa publication.

Exemple

tabcmd delete "Sales_Analysis"

Options

-r, --project

Nom du projet contenant le classeur ou la source de données que vous souhaitez supprimer. Si aucun nom n’est spécifié, le projet "Par défaut" est utilisé.

--parent-project-path

Indique le nom du projet parent pour le projet imbriqué tel que spécifié avec l’option -r. Par exemple, pour spécifier un projet appelé « Nested » existant dans un projet « Main », utilisez la syntaxe suivante : --parent-project-path "Main" -r "Nested".

--workbook

Nom du classeur que vous souhaitez supprimer.

--datasource

Nom de la source de données que vous souhaitez supprimer.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

deleteextracts

Supprime des extraits pour un classeur ou une source de données publié(e).

Options

-d, --datasource

Nom de la source de données cible pour la suppression d’extrait.

--embedded-datasources

Liste de valeurs séparées par un espace des noms des sources de données intégrées dans le classeur cible. Entourez les noms des sources de données entre guillemets doubles s’ils contiennent des espaces. Disponible uniquement lors de la suppression d’extraits pour un classeur.

--encrypt

Créer un extrait crypté.

--include-all

Inclure toutes les sources de données intégrées dans le classeur cible.

--parent-project-path

Chemin du projet qui est le parent du projet contenant la ressource cible. Vous devez spécifier le nom du projet avec --project.

--project

Nom du projet contenant la ressource cible. Nécessaire uniquement si --workbook ou --datasource est spécifié. Si non spécifié, le projet par défaut « Default » est utilisé.

-u, -url

Nom canonique du classeur tel qu’il apparaît dans l’URL.

-w, -workbook

Nom du classeur cible pour la suppression d’extrait.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

deletegroup group-name

Supprime le groupe spécifié du serveur.

Exemple

tabcmd deletegroup "Development"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

deleteproject project-name

Supprime le projet spécifié du serveur.

La commande tabcmd vous permet de spécifier un projet de niveau supérieur seulement dans une hiérarchie de projet. Pour automatiser les tâches que vous souhaitez effectuer sur un projet dans un projet parent, utilisez l’appel Tableau REST API(Le lien s’ouvre dans une nouvelle fenêtre) équivalent.

Exemple

tabcmd deleteproject "Designs"

Option

--parent-project-path

Spécifie le nom du projet parent pour le projet imbriqué tel que spécifié avec la commande. Par exemple, pour spécifier un projet appelé « Designs » existant dans un projet « Main », utilisez la syntaxe suivante : --parent-project-path "Main" "Designs".

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

deletesite nom_site

Supprime le site spécifié du serveur.

Exemple

tabcmd deletesite "Development"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

deletesiteusers filename.csv

Supprime les utilisateurs du site auquel vous êtes connecté. Les utilisateurs à supprimer sont spécifiés dans un fichier qui contient une liste simple avec un nom d’utilisateur par ligne. (Aucune information supplémentaire n’est requise au-delà du nom d’utilisateur.)

Par défaut, si le serveur n’a qu’un seul site ou si l’utilisateur appartient à un seul site, l’utilisateur est également supprimé du serveur. Sur une installation Tableau Server Enterprise, si le serveur contient plusieurs sites, les utilisateurs ayant le rôle sur le site Administrateur de serveur sont supprimés du site mais pas du serveur.

Si l’utilisateur est propriétaire de contenu, son rôle passe à Sans licence, mais l’utilisateur n’est pas supprimé du serveur ou du site. Le contenu est toujours détenu par cet utilisateur. Pou supprimer complètement l’utilisateur, vous devez modifier le propriétaire du contenu, puis essayez de supprimer à nouveau l’utilisateur.

Si l’utilisateur a été importé d’Active Directory, l’utilisateur est supprimé du site, et probablement du serveur. Cependant, l’utilisateur n’est pas supprimé d’Active Directory.

Exemple

tabcmd deletesiteusers "users.csv"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

deleteusers filename.csv

Supprime les utilisateurs répertoriés dans le fichier de valeurs séparées par une virgule (.csv) spécifié.

Le fichier .csv doit se composer d’une simple liste avec un nom d’utilisateur par ligne.

Exemple

tabcmd deleteusers "users.csv"

Options

--[no-]complete

Lorsqu’elle est définie sur --complete, cette option requiert que toutes les lignes soient valides pour que les modifications prennent effet. Sinon, --complete est utilisé.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

editdomain

Remarque : selon les meilleures pratiques, vous devez sauvegarder Tableau Server avant de modifier le domaine. Le domaine est enregistré dans le référentiel Tableau, et s’il est incorrectement modifié, les administrateurs risquent ne pas pouvoir se connecter.

Change le surnom ou le nom de domaine complet d’un domaine Active Directory sur le serveur. Le surnom du domaine est le nom de domaine NetBIOS de Windows.

Vous pouvez modifier le surnom de tous les domaines que le serveur utilise. De manière générale, vous pouvez modifier le nom de domaine complet de n’importe quel domaine excepté celui utilisé pour vous connecter. Toutefois, si le nom d’utilisateur actuellement connecté existe à la fois dans le domaine actuel et dans le nouveau domaine, vous pouvez modifier le nom complet du domaine actuel.

Pour être sûr que Tableau Server puisse se connecter à d’autres domaines Active Directory, vous devez également spécifier des domaines secondaires auxquels Tableau Server se connecte en définissant l’option wgserver.domain.whitelist avec TSM. Pour plus d’informations sur les domaines secondaires et la configuration de la connexion, voir wgserver.domain.whitelist.

Analysez Gestion des utilisateurs dans les déploiements avec magasins d’identités externes pour comprendre comment plusieurs domaines, le mappage de nom de domaine et les noms d’utilisateurs interagissent avec Tableau Server.

Pour voir une liste de domaines, utilisez listdomains.

Exemples

tabcmd editdomain --id 2 --nickname "new-nickname"

tabcmd editdomain --id 3 --name "new-name"

Options

--id

L’ID de domaine à modifier. Pour obtenir une liste d’ID de domaine, utilisez listdomains.

--name

Nouveau nom du domaine.

--nickname

Nouveau surnom du groupe.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

editsite nom_site

Change le nom d’un site ou le nom de son dossier Web. Vous pouvez également utiliser cette commande pour autoriser les administrateurs de site à ajouter et supprimer des utilisateurs ou leur interdire, ou empêcher les utilisateurs d’exécuter certaines tâches manuellement. Si les administrateurs de site disposent des droits de gestion des utilisateurs, vous pouvez définir le nombre d’utilisateurs qu’ils peuvent ajouter à un site.

Exemples

tabcmd editsite wc_sales --site-name "West Coast Sales"

tabcmd editsite wc_sales --site-id "wsales"

tabcmd editsite wsales --status ACTIVE

tabcmd editsite wsales --user-quota 50

Options

--site-name

Le nom du site qui s’affiche.

--site-id

Utilisé dans l’URL pour identifier le site de manière unique.

--user-quota

Nombre maximum d’utilisateurs pouvant être membres du site.

--[no-]site-mode

Autorisez ou empêchez les administrateurs du site d’y ajouter des utilisateurs.

--status

Définissez sur ACTIVE pour activer un site, ou sur SUSPENDED pour suspendre un site.

--storage-quota

En Mo, le volume de classeurs, extraits et sources de données pouvant être stockés sur le site.

--extract-encryption-mode

Le mode de cryptage d’extrait pour le site peut être forcé, activé ou désactivé. Pour plus d’informations, consultez Cryptage d’extrait au repos. Selon le nombre et la taille des extraits, cette opération peut consommer des ressources serveur importantes.

--run-now-enabled

Autorisez ou non les utilisateurs à exécuter manuellement des actualisations d’extraits, des flux ou des planifications. true pour autoriser les utilisateurs à exécuter des tâches manuellement ou false pour empêcher les utilisateurs d’exécuter des tâches manuellement. Pour plus d’informations, consultez Paramètres du serveur (Général et Personnalisation).

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

encryptextracts

Crypte tous les extraits sur un site. Si aucun site n’est spécifié, les extraits du site par défaut seront cryptés. Pour plus d’informations, consultez Cryptage d’extrait au repos.

Selon le nombre et la taille des extraits, cette opération peut consommer des ressources serveur importantes. Envisagez d’exécuter cette commande en dehors des heures ouvrables normales.

Exemple

tabcmd encryptextracts "West Coast Sales"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

export

Exporte une vue ou un classeur à partir de Tableau Server et l’enregistre dans un fichier. Cette commande peut aussi exporter uniquement les données utilisées pour une vue. Les données de la vue sont exportées au niveau résumé. Pour exporter des données de niveau de détail, vous devez utiliser l’interface utilisateur Tableau Server. Pour plus d’informations, consultez Télécharger des vues et des classeurs(Le lien s’ouvre dans une nouvelle fenêtre).

Lisez les points suivants avant d’utiliser cette commande :

  • Autorisations : Pour pouvoir exporter, vous devez bénéficier de l’autorisation d’Exportation d’une image. Par défaut, la valeur de cette autorisation est définie sur Autorisée ou Héritée pour tous les rôles, mais elle peut être définie par classeur ou par vue.

  • Exportation de données : Pour exporter uniquement les données d’une vue, utilisez l’option --csv. Cette opération exporte les données de résumé utilisées dans la vue dans un fichier .csv.

  • Spécification de la vue, du classeur ou des données à exporter :

    • Utilisez la partie de l’URL pour identifier les éléments à exporter, plus spécifiquement la chaîne "workbook/view" telle qu’elle apparaît dans l’URL du classeur ou de la vue. N’utilisez pas le nom convivial et excluez l’ID de session :iid=<n> à la fin de l’URL.

      Par exemple, l’exemple de vue Tableau Détails de la commande dans le classeur Exemple - Hypermarché a une URL du type suivant : <server_name>/#/views/Superstore/OrderDetails?:iid=2

      Pour exporter la vue Détails de la commande, utilisez la chaîne Superstore/OrderDetails.

      N’utilisez pas Superstore/Order Details ni Superstore/OrderDetails?:iid=2.

    • Si le serveur fait fonctionner plusieurs sites et que la vue ou le classeur se trouve sur un site autre que celui par défaut, utilisez -t <site_id>.

    • Pour exporter un classeur, obtenez la chaîne d’URL en ouvrant une vue dans le classeur, et incluez la vue dans la chaîne que vous utilisez.

      Dans l’exemple ci-dessus, pour exporter le classeur Hypermarché, vous devez utiliser la chaîne Superstore/OrderDetails.

    • Pour exporter un classeur, l’option Afficher les feuilles sous forme d’onglets doit être sélectionnée dans la boîte de dialogue Publier de Tableau Desktop au moment de sa publication.

      Remarque : le classeur Tableau qui contient le les vues administratives(Le lien s’ouvre dans une nouvelle fenêtre) ne peut pas être exporté.

    • Pour filtrer les données que vous téléchargez, ajoutez un filtre de paramètre à l’aide de ce format :

      ?<filter_name>=value

      ou, en cas de filtrage d’un paramètre et si ce paramètre a un nom d’affichage qui correspond au nom d’une mesure ou d’une dimension :

      ?Parameters.<filter_name>=value

  • Format du fichier sauvegardé : Les formats proposés dépendent du contenu exporté. Un classeur ne peut être exporté qu’en PDF, en utilisant l’argument --fullpdf. La vue peut être exportée au format PDF (--pdf) ou PNG (--png).

  • Nom et emplacement du fichier sauvegardé (facultatif) : Si vous ne définissez pas de nom, celui-ci sera nommé automatiquement à partir du nom de la vue ou du classeur. Si vous ne définissez pas d’emplacement, le fichier sera sauvegardé dans le répertoire de travail courant. Vous pouvez également spécifier un chemin absolu ou relatif au répertoire de travail courant.

    Remarque : vous devez inclure une extension de nom de champ telle que .csv ou .pdf. La commande n’ajoute pas automatiquement une extension au nom de fichier que vous fournissez.

  • Objets de page Web du tableau de bord non inclus dans les exports PDF : Un tableau de bord peut inclure, au choix, un objet de page Web. Si vous réalisez l’exportation en PDF d’un tableau de bord contenant un objet de page Web, celui-ci ne sera pas inclus dans le fichier PDF.

  • Caractères non-ASCII/caractères ASCII non standard et exportations PDF : si vous exportez une vue ou un classeur dont le nom inclut un caractère non-ASCII ou un caractère ASCII non standard, vous devez encoder le caractère dans l’URL (encodage avec pourcentage).

    Par exemple, si votre commande inclut la ville de Zürich, vous devez l’encoder avec une URL sous la forme Z%C3%BCrich :

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

Effacement du cache pour utiliser des données en temps réel

Vous pouvez éventuellement ajouter le paramètre URL ?:refresh=yes pour forcer une requête de rafraîchissement des données au lieu de demander les résultats du cache. Si vous utilisez tabcmd avec votre propre script et que le paramètre URL refresh est très utilisé, cela peut avoir un impact négatif sur les performances. Il est recommandé d’utiliser la commande refresh uniquement lorsque vous avez besoin des données en temps réel—par exemple, sur un tableau de bord unique au lieu d’un classeur entier.

Exemples

Vues

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

Classeurs

tabcmd export "Q1Sales/Sales_Report" --fullpdf

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

Options

-f, --filename

Enregistre le fichier avec le nom et l’extension donnés.

--csv

Disponible pour les vues uniquement. Exportez les données de la vue (données résumées) au format .csv.

--pdf

Disponible pour les vues uniquement. Permet d’exporter au format PDF.

--png

Disponible pour les vues uniquement. Exportez en tant qu’image au format .png.

--fullpdf

Disponible pour les classeurs uniquement. Permet d’exporter au format PDF. L’option Afficher les feuilles sous forme d’onglets doit être activée au moment de la publication du classeur.

--pagelayout

Définit l’orientation de la page (landscape ou portrait) du PDF exporté. Si cette option n’est pas définie, les paramètres Tableau Desktop seront utilisés.

--pagesize

Définit la taille de page du fichier PDF exporté sous l’un des formats suivants : unspecified, letter, legal, note folio, tabloid, ledger, statement, executive, a3, a4, a5, b4, b5 ou quarto. La valeur par défaut est letter.

--width

Définit la largeur en pixels. La valeur par défaut est 800 px.

--height

Définit la hauteur en pixels. La valeur par défaut est 600 px.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

get url

Obtient la ressource de Tableau Server, qui est représentée par l’URL (partielle) spécifiée. Le résultat est renvoyé comme un fichier.

Lisez les points suivants avant d’utiliser cette commande :

  • Autorisations : Pour récupérer un fichier, vous devez disposer de l’autorisation Télécharger/Enregistrer sur le Web sous. Par défaut, la valeur de cette autorisation est définie sur autorisée ou héritée pour tous les rôles, mais elle peut être définie par classeur ou par vue.

  • Définition d’une vue ou d’un classeur à obtenir : vous spécifiez une vue à obtenir avec la chaîne "/views/<workbookname>/<viewname>.<extension>" et un classeur à obtenir avec la chaîne "/workbooks/<workbookname>.<extension>". Remplacez <workbookname>  et <viewname> par les noms du classeur et affichez-les comme ils apparaissent dans l’URL lorsque vous ouvrez la vue dans un navigateur et remplacez <extension> par le type de fichier que vous souhaitez enregistrer. N’utilisez pas l’ID de session à la fin de l’URL (?:iid=<n>) ni le nom convivial du classeur ou de la vue.

    Par exemple, si vous ouvrez une vue Regional Totals dans un classeur nommé Metrics Summary, l’URL ressemble à ce qui suit :

    /views/MetricsSummary_1/RegionalTotals?:iid=1

    Servez-vous de la chaîne /views/MetricsSummary_1/RegionalTotals.<extension> pour obtenir la vue.

    Servez-vous de la chaîne /workbooks/MetricsSummary_1.<extension> pour obtenir le classeur.

    Lors du téléchargement de classeurs et de vues depuis Tableau Server, le contenu du fichier .twb ou .twbx est stocké en texte simple. Toutes les données, y compris les valeurs de filtre qui peuvent donner des indices sémantiques sur les données, seront lisibles par toute personne qui ouvre le fichier.

  • Extension du fichier : l’URL doit contenir une extension de fichier. L’extension détermine le type de fichier généré. Pour une vue, vous pouvez utiliser les formats PDF, PNG ou CSV (données résumées uniquement). Un classeur Tableau est enregistré au format TWB s’il se connecte à une source de données publiées ou s’il utilise une connexion en direct. Il est enregistré au format TWBX s’il se connecte à un extrait de données.

    Remarque : si vous téléchargez une vue vers un fichier PDF ou PNG et si vous incluez un paramètre --filename portant l’extension .pdf ou .png, vous n’avez pas besoin d’inclure une extension .pdf ou .png dans l’URL.

  • Nom et emplacement du fichier sauvegardé (facultatif) : Le nom spécifié pour l’option --filename doit inclure une extension. Si vous ne fournissez pas de nom ni d’extension de fichier, ceux-ci seront obtenus à partir de la chaîne URL. Si vous ne définissez pas d’emplacement, le fichier est sauvegardé dans le répertoire de travail courant. Vous pouvez également spécifier un chemin absolu ou relatif au répertoire de travail courant.

  • taille PNG (facultatif) : Si le fichier enregistré est au format PNG, vous pouvez en spécifier la taille, en pixels, dans l’URL.

Effacement du cache pour utiliser des données en temps réel

Vous pouvez éventuellement ajouter le paramètre URL ?:refresh=yes pour forcer une requête de rafraîchissement des données au lieu de demander les résultats du cache. Si vous utilisez tabcmd avec votre propre script, l’utilisation intensive de la commande refresh peut avoir un impact négatif sur les performances. Il est recommandé d’utiliser la commande refresh uniquement lorsque vous avez besoin des données en temps réel—par exemple, sur un tableau de bord unique au lieu d’un classeur entier.

Exemples

Vues

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

Classeurs

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

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

initialuser

Créez l’utilisateur administratif initial de serveur sur un serveur sur lequel aucun utilisateur administratif initial n’a été défini. Un administrateur de serveur est alors créé. Cela ne crée pas d’administrateur TSM.

Entourez les valeurs entre guillemets simples.

Remarque : la commande tabcmd initialuser ne nécessite pas l’authentification à Tableau Server, mais elle doit être exécutée sur le nœud du serveur initial.

Remarques :

  • la commande tabcmd initialuser ne nécessite pas l’authentification à Tableau Server, mais elle doit être exécutée sur le nœud du serveur initial.
  • La valeur username ne peut pas inclure un arobase (@) à moins que le suffixe du nom d’utilisateur ne corresponde au domaine principal de Tableau Server. Par exemple, si Tableau Server se connecte au domaine « myco.com », il n’est pas possible d’utiliser un nom d’utilisateur « user@example.com@myco.com ».

Exemples

tabcmd initialuser --username 'admin' --password 'password' --server http://localhost

tabcmd initialuser --username 'admin' --password 'password' --friendly 'Tableau Admin' --server http://localhost

Pour inviter à saisir le mot de passe dans l’interpréteur de commandes, n’incluez pas le paramètre --password dans la commande. Par exemple :

tabcmd initialuser --username 'admin' --server http://localhost

Options

-f, --friendly

Crée l’utilisateur administratif initial de serveur avec le nom d’affichage.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

listdomains

Affiche une liste des domaines Active Directory qui sont utilisés sur le serveur, avec leurs surnoms et ID. Si le serveur est configuré pour utiliser une authentification locale, la commande renvoie uniquement le nom de domaine local.

Exemple

tabcmd listdomains

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

listsites

Renvoie une liste des sites auxquels appartient l’utilisateur connecté.

Exemple

tabcmd listsites --username adam --password mypassword

Options

--get-extract-encryption-mode

Le mode de cryptage d’extrait pour le site peut être forcé, activé ou désactivé. Pour plus d’informations, consultez Cryptage d’extrait au repos.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

login

Connecte un utilisateur Tableau Server.

Utilisez les options générales --server, --site, --username et --password pour créer une session.

Remarque : Lorsque vous utilisez la commande tabcmd login, vous ne pouvez pas utiliser la connexion unique SAML (SSO), même si le serveur est configuré pour utiliser SAML. Pour vous connecter, vous devez fournir le nom d’utilisateur et le mot de passe d’un utilisateur qui a été créé sur le serveur. Vous disposerez des autorisations de l’utilisateur Tableau Server sous lequel vous êtes connecté. Pour plus d’informations, consultez Définir les rôles sur le site des utilisateurs et Autorisations.

Si vous souhaitez vous connecter à l’aide des mêmes informations que celles utilisées pour créer une session, spécifiez simplement l’option --password. Le serveur et le nom d’utilisateur stockés dans le cookie seront utilisés.

Si le serveur utilise un port autre qu’un port 80 (par défaut), il faudra indiquer le port.

L’option --site (-t) ne sera utile que si le serveur exécute plusieurs sites et que vous êtes connecté à un site autre que le site Par défaut. Vous serez invité à fournir un mot de passe si vous ne l’avez pas fait. Si l’option --no-prompt est spécifiée et qu’aucun mot de passe n’est fourni, la commande échoue.

Une fois connecté, la session reste ouverte jusqu’à son expiration sur le serveur ou jusqu’à l’exécution de la commande logout.

Exemple

Permet de connecter l’utilisateur jsmith à l’instance Tableau Server en cours d’exécution sur son ordinateur local :

tabcmd login -s http://localhost -u jsmith -p password

Permet de connecter l’administrateur au site Sales sur un serveur sales-server :

tabcmd login -s http://sales-server -t Sales -u administrator -p password

tabcmd login -s http://sales-server:8000 -t Sales -u administrator -p password

Permet de connecter un administrateur au site Sales sur sales-server en utilisant SSL, mais ne valide pas le certificat SSL du serveur :

tabcmd login --no-certcheck -s https://sales-server -t Sales -u administrator -p password

Établit un proxy et un port direct pour localhost :

tabcmd login --proxy myfwdproxyserver:8888 -s http://localhost -u jsmith -p password

Permet de connecter l’utilisateur jsmith au proxy inverse à l’aide de SSL :

tabcmd login -s https://myreverseproxy -u jsmith -p password

Options

-s, --server

Si vous exécutez la commande depuis un ordinateur Tableau Server qui se trouve sur votre réseau, vous pouvez utiliser http://localhost. Sinon, spécifiez l’URL de l’ordinateur, telle que http://bigbox.myco.com ou http://bigbox.

Si le serveur utilise SSL, vous devrez spécifier https:// dans l’URL de l’ordinateur.

Pour Tableau Cloud, spécifiez l’URL complète, y compris le pod sur lequel votre site est déployé. Par exemple : https://prod-useast-b.online.tableau.com.

-t, --site

Incluez cette option si le serveur dispose de plusieurs sites et que vous êtes connecté à un site autre que le site par défaut.

L’ID de site est utilisé dans l’URL pour identifier le site de manière unique. Par exemple, un site nommé West Coast Sales peut disposer d’un ID de site west-coast-sales.

-u, --username

Nom d’utilisateur de l’utilisateur qui se connecte. Pour Tableau Cloud, le nom d’utilisateur est l’adresse de messagerie de l’utilisateur.

-p, --password

Mot de passe de l’utilisateur spécifié pour --username. Vous serez invité à fournir un mot de passe si vous ne l’avez pas fait.

--password-file

Permet d’enregistrer le mot de passe dans le fichier filename.txt indiqué au lieu de le saisir sur la ligne de commande, pour plus de sécurité.

-x, --proxy

Utilisez-la pour spécifier le serveur proxy HTTP et le serveur (hôte:port) pour la demande tabcmd.

--no-prompt

Ne pas demander un mot de passe. Si aucun mot de passe n’est spécifié, la commande login échoue.

--no-proxy

Ne pas utiliser un serveur proxy HTTP.

--cookie

Enregistre l’ID de session lors de la connexion. Les commandes suivantes ne requièrent pas de connexion. Cette valeur est la valeur par défaut de la commande.

--no-cookie

Ne pas enregistrer pas les informations d’ID de session après une connexion réussie. Les commandes suivantes requièrent une connexion.

--timeout SECONDS

Le nombre de secondes d’attente du serveur avant le traitement de la commande login. Par défaut : 30 secondes.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

logout

Permet de se déconnecter du serveur.

Exemple

tabcmd logout

publish filename.twb(x), filename.tds(x) ou filename.hyper

Publie le classeur spécifié (.twb(x)), la source de données (.tds(x)) ou l’extrait de données (.hyper) sur Tableau Server.

Si vous publiez un classeur, par défaut, toutes les feuilles du classeur sont publiées sans nom d’utilisateur ni mot de passe de base de données.

Les autorisations initialement attribuées au classeur ou à la source de données sont copiées du projet dans lequel le fichier est publié. Les autorisations pour la ressource publiée peuvent être modifiées une fois le fichier publié. 

Si le classeur contient des filtres utilisateur, l’une des options de miniatures doit être spécifiée.

Exemple

tabcmd publish "analysis.twbx" -n "Sales_Analysis" --db-username "jsmith" --db-password "secret-password"

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

Si le fichier ne se trouve pas dans le même répertoire que tabcmd, indiquez le chemin complet du fichier.

Exemple

tabcmd publish "\\computer\volume\Tableau Workbooks\analysis.twbx" -n "Sales_Analysis" --db-username "jsmith" --db-password "secret-password"

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

Options

-n, --name

Nom du classeur ou de la source de données sur le serveur. Par défaut, le classeur, la source de données ou l’extrait de données portera le même nom que le fichier dont il est tiré.

-o, --overwrite

Ecrase le classeur, la source de données ou l’extrait de données si ceux-ci existent déjà sur le serveur.

-r, --project

Publie le classeur, la source de données ou l’extrait de données dans le projet spécifié. Si aucun projet n’est spécifié, le classeur est publié dans le projet "Par défaut".

--parent-project-path

Indique le nom du projet parent pour le projet imbriqué tel que spécifié avec l’option -r. Par exemple, pour spécifier un projet appelé « Nested » existant dans un projet « Main », utilisez la syntaxe suivante : --parent-project-path "Main" -r "Nested".

--db-username

Utilisez cette option pour publier un nom d’utilisateur de base de données avec le classeur, la source de données ou l’extrait de données.

--db-password

Utilisez cette option pour publier un mot de passe de base de données avec le classeur, la source de données ou l’extrait.

--save-db-password

Enregistre le mot de passe de base de données fourni sur le serveur.

--oauth-username

Adresse e-mail du compte utilisateur. Connecte l’utilisateur via une connexion OAuth préconfigurée, si l’utilisateur a enregistré un jeton d’accès pour la source de données Cloud spécifiée dans --name. Les jetons d’accès sont gérés dans les préférences de l’utilisateur.

Pour les connexions OAuth existantes à la source de données, utilisez cette option plutôt que --db-username et --db-password.

--save-oauth

Enregistre les informations d’identification spécifiées par --oauth-username comme données d’identification intégrées à la source de données ou au classeur publié.

Par conséquent, lorsque le publicateur ou l’administrateur du serveur se connecte au serveur et modifie la connexion pour ce classeur ou cette source de données, les paramètres de connexion présentent ces informations d’identification OAuth comme intégrées au contenu.

Si vous souhaitez programmer des actualisations d’extraits après la publication, vous devez inclure cette option avec --oauth-username. Cela revient à utiliser la commande --save-db-password avec une connexion de base de données traditionnelle.

--thumbnail-username

Si le classeur contient des filtres utilisateur, les miniatures seront générées en fonction de ce que peut voir l’utilisateur spécifié. Ne peut être spécifié lorsque l’option --thumbnail-group est définie.

--thumbnail-group

Si le classeur contient des filtres utilisateur, les miniatures seront générées en fonction de ce que peut voir le groupe spécifié. Ne peut être spécifié lorsque l’option --thumbnail-username est définie.

--tabbed

Lorsqu’un classeur avec des vues présentant des onglets est publié, chaque feuille devient un onglet dont les observateurs peuvent se servir pour naviguer dans le classeur. Notez que ce paramètre remplace la sécurité au niveau des feuilles.

--append

Ajoutez le fichier de l’extrait à la source de données existante.

--replace

Utilisez le fichier de l’extrait pour remplacer la source de données existante.

--disable-uploader

Désactivez l’outil de téléchargement de fichier incrémentiel.

--restart

Redémarrez le téléchargement du fichier.

--encrypt-extracts

Cryptez les extraits lorsque vous publiez un classeur, une source de données ou un extrait sur le serveur. Pour plus d’informations, consultez Cryptage d’extrait au repos.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

publishsamples

Description

Publie des exemples de classeurs Tableau dans le projet spécifié. Tout exemple existant sera remplacé.

Syntaxe

tabcmd publishsamples -n [project name] [Global options]

Exemple

Publiez des exemples dans le projet Inside Sales sur le site Par défaut, en tant qu’utilisateur jsmith.

tabcmd publishsamples -n "Inside Sales" -t "" -s localhost --username "jsmith" --password "secret-password"

Options

-n, --name

Obligatoire. Publie les exemples Tableau dans le projet spécifié. Si le nom du projet inclut des espaces, mettez tout le nom entre guillemets.

--parent-project-path

Indique le nom du projet parent pour le projet imbriqué tel que spécifié avec l’option -n. Par exemple, pour spécifier un projet appelé « Nested » existant dans un projet « Main », utilisez la syntaxe suivante : --parent-project-path "Main" -n "Nested".

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

reencryptextracts

Recryptez tous les extraits d’un site avec de nouvelles clés de cryptage. Cette commande regénère la clé de cryptage de la clé et la clé de cryptage des données. Vous devez spécifier un site. Pour plus d’informations, consultez Cryptage d’extrait au repos.

Selon le nombre et la taille des extraits, cette opération peut consommer des ressources serveur importantes. Envisagez d’exécuter cette commande en dehors des heures ouvrables normales.

Exemples

tabcmd reencryptextracts "Default"

tabcmd reencryptextracts "West Coast Sales"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

refreshextracts workbook-name ou datasource-name

Effectue une actualisation complète ou incrémentielle d’extraits appartenant au classeur ou à la source de données spécifié.

Cette commande utilise le nom du classeur ou de la source de données tel qu’il apparaît sur le serveur, et non le nom de champ lors de sa publication. Seul un administrateur ou le propriétaire du classeur ou de la source de données est autorisé à effectuer cette opération.

Remarque : cette méthode échouera et entraînera une erreur si votre administrateur de serveur a désactivé le paramètre RunNow pour le site. Pour plus d’informations, consultez Paramètres Tableau Server(Le lien s’ouvre dans une nouvelle fenêtre).

Exemples

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

Options

--incremental

Exécute l’opération d’actualisation incrémentielle.

--synchronous

Ajoute l’opération d’actualisation complète à la file d’attente utilisée par le processus backgrounder afin qu’elle soit exécutée aussitôt que le backgrounder sera disponible. Si le processus backgrounder est disponible, l’opération s’exécute immédiatement. L’opération d’actualisation apparaît dans le rapport des tâches d’arrière-plan.

Pendant une actualisation synchrone, tabcmd maintient une connexion en direct avec le serveur pendant que l’opération d’actualisation est en cours, avec interrogation à chaque seconde jusqu’à ce que le travail en arrière-plan soit terminé.

Remarque : L’option --synchronous n’est pas disponible pour les sources de données actualisées avec Tableau Bridge.

--workbook

Nom du classeur contenant les extraits à actualiser. Si le nom du classeur comporte des espaces, placez-le entre guillemets.

--datasource

Nom de la source de données contenant les extraits à actualiser.

--project

Utilisez cette option avec --workbook ou --datasource afin d’identifier un classeur ou une source de données dans un projet autre que Par défaut. Si aucun nom n’est spécifié, le projet Par défaut est utilisé.

--parent-project-path

Indique le nom du projet parent pour le projet imbriqué tel que spécifié avec l’option --project.

Par exemple :

  • Pour spécifier un projet appelé « Nested » existant dans un projet « Main », utilisez la syntaxe suivante :
  • --parent-project-path "Main" --project "Nested"
  • Pour spécifier un projet appelé « Nested2 » imbriqué dans le cadre du projet « Nested » : 
  • --parent-project-path "Main/Nested" --project "Nested2"

--url

Nom du classeur tel qu’il apparaît dans l’URL. Le nom URL d’un classeur publié en tant que « Sales Analysis » est « SalesAnalysis ».

--addcalculations

Utilisez avec --workbook pour matérialiser les calculs dans l’extrait intégré du classeur, ou --datasource pour matérialiser les calculs dans la source de données d’un extrait. Ajoute l’opération à la file d’attente utilisée par le processus Backgrounder. Si un processus Backgrounder est disponible, l’opération s’exécute immédiatement. Cette opération apparaît dans la vue administrative Tâches d’arrière-plan pour les extraits .

--removecalculations

Utilisez avec --workbook ou --datasource pour supprimer les calculs qui étaient précédemment matérialisés. Ajoute l’opération à la file d’attente utilisée par le processus Backgrounder. Si un processus Backgrounder est disponible, l’opération s’exécute immédiatement. Cette opération apparaît dans la vue administrative Tâches d’arrière-plan pour les extraits .

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

reset_openid_sub

Efface les identifiants OpenID Connect (sous-valeurs) qui ont déjà été associés aux identités Tableau Server. Consultez Modification des IdP dans Tableau Server pour OpenID Connect.

Exemple

tabcmd reset_openid_sub --target-username jsmith

Options

--target-username

Efface la sous-valeur pour l’utilisateur individuel spécifié.

--all

Efface les sous-valeurs pour tous les utilisateurs.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

removeusers group-name

Supprime les utilisateurs du groupe spécifié.

Exemple

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

Options

--users

Supprimez du groupe spécifié les utilisateurs qui se trouvent dans le fichier .csv donné. Le fichier doit se composer d’une liste simple avec un nom d’utilisateur par ligne.

--[no-]complete

Requiert que toutes les lignes soient valides pour que les modifications prennent effet. Sinon, --complete est utilisé.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

runschedule schedule-name

Exécute les tâches selon le calendrier spécifié pour le site auquel vous êtes actuellement connecté. Vous ne pouvez pas l’exécuter pour tous les sites utilisant tabcmd. Pour exécuter les tâches programmées pour tous les sites, connectez-vous à l’interface Web, depuis la page Programmations, sélectionnez Tous les sites, puis effectuez une opération Exécuter maintenant de manière programmée.

Cette commande prend le nom de la programmation tel qu’il est spécifié sur le serveur.

Cette commande n’est pas disponible pour Tableau Cloud.

Remarque : cette méthode échouera et entraînera une erreur si votre administrateur de serveur a désactivé le paramètre RunNow pour le site. Pour plus d’informations, consultez Paramètres Tableau Server(Le lien s’ouvre dans une nouvelle fenêtre).

Exemple

tabcmd runschedule "5AM Sales Refresh"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

set paramètre

Active le paramètre spécifié sur le serveur. Vous trouverez des détails sur chaque paramètre sur la page Maintenance du serveur.

Pour désactiver un paramètre, placez un point d’exclamation devant son nom. Vous pouvez activer ou désactiver les paramètres suivants :

  • allow_scheduling

  • embedded_credentials

  • remember_passwords_forever

Exemple

tabcmd set embedded_credentials

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

syncgroup nom_groupe

Synchronise un groupe Tableau Server avec un groupe Active Directory. Si le groupe Tableau Server n’existe pas encore, il est créé et synchronisé avec le groupe Active Directory spécifié.

Si le nom du groupe lui-même inclut un symbole « @ » (autre que le séparateur de domaine), vous devez vous reporter au symbole en utilisant le format hexadécimal « \0x40 ».

Exemple

tabcmd syncgroup "Development"

tabcmd syncgroup "Dev\0x40West"

Remarque : si vous synchronisez un groupe dont vous êtes membre, les modifications que vous apportez en utilisant cette commande ne s’appliquent pas à votre utilisateur. Par exemple, si vous utilisez cette commande pour supprimer le droit Administrateur des utilisateurs d’un groupe dont vous êtes membre, vous restez administrateur lorsque la commande se termine.

Options

--grant-license-mode <grant-license-mode>

Spécifie si un rôle doit être attribué lors de la connexion. La valeur par défaut est on-sync. Les valeurs valides sont on-login, on-sync. Si aucune valeur n’est spécifiée, on-sync est présupposé et le rôle par défaut sera attribué lors de la synchronisation du groupe. Pour plus d’informations, voir Modification des rôles utilisateur avec l’attribution de rôle lors de la connexion.

--no-publisher

Obsolète. À la place, utilisez l’option --role.

--overwritesiterole

Autorise la redéfinition du rôle sur le site d’un utilisateur sur un rôle moins élevé si --role est utilisé. Par défaut, le rôle sur le site d’un utilisateur peut être élevé au rôle suivant avec l’option --role, mais il ne peut pas être abaissé à un rôle moins élevé. Puisque l’option --overwritesiterole ne permet pas d’abaisser les rôles sur le site des utilisateurs, soyez prudent dans son utilisation.

--publisher

Obsolète. À la place, utilisez l’option --role.

-r, --role

Indique un rôle sur le site pour les utilisateurs du groupe. La valeur par défaut est Unlicensed.

Les valeurs valides sont : SiteAdministratorCreator, SiteAdministratorExplorer, SiteAdministrator, Creator, ExplorerCanPublish, Publisher, Explorer, Interactor, Viewer, Unlicensed.

--silent-progress

Ne pas afficher les messages de progression pour la commande.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

upgradethumbnails

Démarre et arrête le travail de mise à niveau des images miniatures. Pour plus d’informations, consultez Tâche de mise à niveau des images miniatures.

Exemples

Pour démarrer le travail de mise à niveau des images miniatures :

tabcmd upgradethumbnails --server <serverURL>

Pour arrêter le travail en cours de mise à niveau des images miniatures :

tabcmd upgradethumbnails --server <serverURL> --stop

Options

--stop

Lorsque cette option est spécifiée, arrête le travail en cours de mise à niveau des images miniatures. Si cette option n’est pas spécifiée, le travail de mise à niveau des images miniatures sera démarré.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

validateidpmetadata

Identifie les sites Tableau Server qui sont configurés avec des IdP à l’aide de l’algorithme digest non sécurisé, SHA-1. Cette commande identifie également les IdP qui utilisent des certificats d’une taille de clé RSA ou de courbe elliptique insuffisante.

Remarque : cette commande est uniquement disponible pour SAML spécifique à un site. Pour plus d’informations, consultez Configurer le protocole SAML spécifique à un site.

Options

--digest-algorithms <ALGORITHMS>

Liste séparée par des espaces d’algorithmes digest. Les valeurs autorisées sont sha1et sha256. En l’absence de spécification, le serveur utilise les valeurs du paramètre de configuration serveur wgserver.saml.blocklisted_digest_algorithms.

--min-allowed-elliptic-curve-size <SIZE>

En l’absence de spécification, le serveur utilise les valeurs du paramètre de configuration serveur wgserver.saml.min_allowed.elliptic_curve_size.

--min-allowed-rsa-key-size <SIZE>

En l’absence de spécification, le serveur utilise les valeurs du paramètre de configuration serveur wgserver.saml.min_allowed.rsa_key_size.

--site-names <SITENAMES>

Liste séparée par des espaces des noms de site sur lesquels exécuter une validation de certificat. En l’absence de spécification, tous les sites sont inspectés.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

version

Affiche les informations de version pour l’installation actuelle de l’utilitaire tabcmd.

Exemple

tabcmd version

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d’authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l’ayant utilisé.

-h, --help

Affiche l’aide de la commande.

-c, --use-certificate

Utilisez un certificat client pour vous connecter. Requis lorsque SSL mutuel est activé.

Pour des informations sur la configuration du certificat, commencez par la rubrique adaptée à votre système d’exploitation Tableau Server :

-s, --server

L’URL Tableau Server, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d’utilisateur Tableau Server, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Server, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d’enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s’applique au site spécifié par l’ID du site Tableau Server, entouré de guillemets simples ou doubles. Pour spécifier le site par défaut, utilisez soit une chaîne vide avec des guillemets simples ou doubles ('' ou ""), soit Default entre guillemets doubles ("Default"). L’ID de site est sensible à la casse lors de l’utilisation d’un jeton d’authentification mis en cache. Si la casse n’est pas respectée, il se peut qu’on vous demande un mot de passe même si le jeton est encore valide.

-x, --proxy

Host:Port

Utilise le proxy HTTP spécifié.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n’est fourni, la commande échoue.

--no-proxy

Lorsque cette option est spécifiée, aucun proxy HTTP n’est utilisé.

--no-certcheck

Lorsque cette option est spécifiée, tabcmd (le client) ne valide pas le certificat SSL du serveur.

--[no-]cookie

Lorsque cette option est spécifiée, l’ID de session est enregistré lors de la connexion afin que les commandes suivantes n’aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l’ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d’attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus attendra que le serveur réponde.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d’option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L’exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

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

Conseil : pour les commandes tabcmd 1.0 disponibles pour Tableau Cloud, consultez Commandes tabcmd(Le lien s’ouvre dans une nouvelle fenêtre).
Merci de vos commentaires !Avis correctement envoyé. Merci