Comandos de tabcmd

Nota: La utilidad de línea de comandos tabcmd versión 2.0 está disponible en Tabcmd de Tableau(El enlace se abre en una ventana nueva). Esta nueva versión le permite ejecutar comandos tabcmd en MacOS y Linux y autenticarse mediante tokens de acceso personal (PAT). La versión 2.0 se basa en puntos de conexión públicos disponibles en Tableau Server Client (TSC) basado en Python. Esta última versión tiene soporte limitado para Tableau Server.

Puede usar los comandos siguientes con la herramienta de línea de comandos tabcmd:

addusers group-name

Agrega usuarios al grupo especificado.

Ejemplo

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

Opciones

--users

Permite añadir los usuarios en el archivo .csv determinado al grupo especificado. El archivo debe ser una lista simple con un nombre de usuario por línea. Los nombres de usuario no distinguen entre mayúsculas y minúsculas. Los usuarios ya deben estar creados en Tableau Server.

Para obtener más información, consulte Pautas de archivos de importación CSV.

--[no-]complete

Al establecerse como complete, esta opción requiere que todas las filas sean válidas para que cualquier cambio tenga éxito. Si no se especifica, se usará el parámetro --complete.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

createextracts

Crea extracciones para un libro de trabajo o una fuente de datos publicada.

Opciones

-d, --datasource

El nombre de la fuente de datos de destino para la creación de la extracción.

--embedded-datasources

Una lista separada por espacios de nombres de fuentes de datos insertadas dentro del libro de trabajo de destino. Cierre los nombres de las fuentes de datos entre comillas dobles si contienen espacios. Solo está disponible al crear extracciones para un libro de trabajo.

--encrypt

Crear una extracción cifrada.

--include-all

Incluir todas las fuentes de datos insertadas en el libro de trabajo de destino. Solo está disponible al crear extracciones para libros de trabajo.

--parent-project-path

Ruta del proyecto que es la matriz del proyecto que contiene el recurso de destino. Debe especificar el nombre del proyecto con --project.

--project

Nombre del proyecto que contiene el recurso de destino. Solo es necesario si se especifica --workbook o --datasource. Si no se especifica, se utiliza el proyecto "Predeterminado".

-u, -url

El nombre canónico del recurso tal como aparece en la URL.

-w, -workbook

El nombre del libro de trabajo de destino para la creación de extracciones.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

creategroup group-name

Crea un grupo. Use el comando addusers (para grupos locales) para agregar usuarios después de haber creado el grupo. Use syncgroup (para grupos de Active Directory) para crear y sincronizar un grupo de Tableau Server con un grupo de Active Directory.

Ejemplo

tabcmd creategroup "Development"

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

createproject project-name

Crea un proyecto.

Ejemplo

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

Opciones

-n, --name

Especifica el nombre del proyecto que desea crear.

--parent-project-path

Especifica el nombre del proyecto primario para el proyecto anidado según lo indicado con la opción -n. Por ejemplo, para especificar un proyecto denominado "Nested" que existe en un proyecto "Main", use la siguiente sintaxis: --parent-project-path "Main" -n "Nested".

-d, --description

Especifica una descripción para el proyecto.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

createsite nombre-sitio

Crea un sitio.

Ejemplos

Crear un sitio con el nombre West Coast Sales. Una ID de sitio de WestCoastSales se creará automáticamente, el sitio no tendrá límite de cuota de almacenamiento y los administradores del sitio podrán agregar y eliminar usuarios:

tabcmd createsite "West Coast Sales"

Crear un sitio con el nombre West Coast Sales y con la ID de sitio wsales:

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

Evita que los administradores del sitio agreguen usuarios al sitio:

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

Defina una cuota de almacenamiento en MB:

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

Opciones

-r, --url

Se utiliza en las URL para especificar el sitio. Es diferente al nombre del sitio.

--user-quota

Número máximo de usuarios que es posible agregar al sitio.

--[no-]site-mode

Permite o deniega a los administradores del sitio la capacidad de añadir usuarios al sitio o eliminarlos.

--storage-quota

Cantidad en MB de libros de trabajo, extracciones y fuentes de datos que se pueden almacenar en el sitio.

--extract-encryption-mode

El modo de cifrado de extracciones para el sitio puede ser forzado, habilitado o deshabilitado. Para obtener más información, consulte Cifrado de extracciones en reposo.

--run-now-enabled

Permita o deniegue a los usuarios la ejecución manual de actualizaciones, flujos o programas de extracciones. Use true para permitir que los usuarios ejecuten tareas manualmente o false para evitar que los usuarios ejecuten tareas manualmente. Para obtener más información, consulte Configuración de Server (general y de personalización).

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

createsiteusers filename.csv

Agrega usuarios a un sitio en función de la información proporcionada en un archivo de valores separados por comas (CSV). Si el usuario aún no está creado en el servidor, el comando lo crea antes de agregarlo al sitio.

El archivo CSV debe contener uno o varios nombres de usuario y puede incluir también (por cada usuario) una contraseña, un nombre completo, un tipo de licencia, un nivel de administrador, información sobre si es publicador (sí o no) y una dirección de correo electrónico. Para obtener información sobre el formato del archivo CSV, consulte Pautas de archivos de importación CSV.

Si no desea incluir el nivel de administrador o los permisos de publicador en el archivo CSV, puede pasar la información de nivel de acceso incluyendo la opción --role y especificando el rol en el sitio que desea asignar a los usuarios relacionados en el archivo CSV.

De forma predeterminada, los usuarios se agregan al sitio en el que haya iniciado sesión. Para agregar usuarios a otro sitio, incluya la opción global --site y especifique ese sitio. (Para crear usuarios en el sitio que especifique, debe tener permisos).

Si el servidor contiene varios sitios, no puede añadir administradores de servidor (sistema) mediante el comando createsiteusers. Use createusers en su lugar. Si especifica el rol en el sitio ServerAdministrator para la opción --role, el comando indica un error. Si el archivo .csv incluye System como valor de administrador, el valor se omite y al usuario se le asigna el tipo de licencia Unlicensed.

Si el servidor contiene únicamente un sitio (el sitio predeterminado), puede especificar system como el valor de administrador para un usuario o incluso asignar el rol en el sitio ServerAdministrator mediante la opción --role si desea que todos los usuarios en el archivo .csv sean administradores de sitio.

De forma predeterminada, este comando crea usuarios mediante una operación síncrona (espera a que terminen todas las operaciones para continuar). Puede usar la opción --no-wait para especificar una operación asíncrona.

Autenticación local

Si el servidor está configurado para usar la autenticación local, se usará la información del archivo CSV para crear los usuarios.

Autenticación con Active Directory

Si el servidor está configurado para usar la autenticación de Active Directory, la información de los usuarios se importa de Active Directory, y la información sobre la contraseña y el nombre descriptivo presente en el archivo CSV se ignora. Además, si un usuario está especificado en el archivo CSV, pero no existe otro que le corresponda en Active Directory, el usuario no se añade a Tableau Server. Para los usuarios de Active Directory, no se garantiza que el nombre de usuario sea exclusivo en los dominios, por lo que debe incluir el dominio como parte del nombre de usuario. Puede especificarlo de dos formas: domain\username o username@domain.com; sin embargo, le recomendamos que use el formato domain\username. Para obtener más información, consulte Administración de usuarios en implementaciones con almacenes de identidades externos.

Ejemplo

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

Opciones

--admin-type

Obsoleto. Use la opción --role en su lugar.

--auth-type

Configura el tipo de autenticación (Local o SAML) para todos los usuarios en el archivo .csv. Si no se especifica nada, el valor predeterminado es Local.

Nota: Para usar la autenticación SAML, el sitio debe estar configurado para SAML específico del sitio en la configuración de Tableau Server. Para obtener más información, consulte Configurar SAML específico de un sitio.

--[no-]complete

Obsoleto. Comportamiento de error predeterminado: si hay más de 3 errores dentro de un intervalo de diez filas, se producirá un error en el comando.

--no-publisher

Obsoleto. Use la opción --role en su lugar.

--nowait

No espera la finalización de trabajos asíncronos.

--publisher

Obsoleto. Use la opción --role en su lugar.

--role

Especifica un rol en el sitio para los usuarios en el archivo .csv. Si desea asignar roles de sitio mediante la opción --role, cree un archivo .csv independiente para cada rol en el sitio.

Valores válidos: ServerAdministrator, SiteAdministratorCreator, SiteAdministratorExplorer, SiteAdministrator, Creator, ExplorerCanPublish, Publisher, Explorer, Interactor, Viewer y Unlicensed.

El valor predeterminado es Unlicensed para los usuarios nuevos y sin cambios para los usuarios existentes. Los usuarios también se añaden como sin licencia si tiene una instalación de servidor basada en usuarios y el comando createsiteusers crea un usuario nuevo, pero ya ha alcanzado el límite de licencias de usuario.

Nota: En un Tableau Server multisitio, si desea asignar el rol en el sitio ServerAdministrator mediante la opción --role, use el comando createusers en lugar de createsiteusers.

--silent-progress

No muestra los mensajes de progreso del comando.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

createusers filename.csv

Crea usuarios en Tableau Server basándose en la información proporcionada en un archivo de valores separados por comas (CSV).

El archivo CSV debe contener uno o varios nombres de usuario y puede incluir también (por cada usuario) una contraseña, un nombre completo, un tipo de licencia, un nivel de administrador, información sobre si es publicador (sí o no) y una dirección de correo electrónico. Para obtener información sobre el formato del archivo CSV, consulte Pautas de archivos de importación CSV.

Si no desea incluir el nivel de administrador o los permisos de publicador en el archivo CSV, puede pasar la información de nivel de acceso incluyendo la opción --role y especificando el rol en el sitio que desea asignar a los usuarios relacionados en el archivo CSV.

Si el servidor solo tiene un sitio (el predeterminado), el usuario se crea y se agrega al sitio. Si el servidor tiene varios sitios, el usuario se crea pero no se agrega a ningún sitio. Para añadir usuarios a un sitio, use createsiteusers.

Si tiene una instalación de servidor basada en usuarios y el comando crea un usuario nuevo, pero ya ha alcanzado el límite de licencias de sus usuarios, el usuario se agregará como usuario sin licencia.

Autenticación local

Si el servidor está configurado para usar la autenticación local, se usará la información del archivo CSV para crear los usuarios.

Autenticación con Active Directory

Si el servidor está configurado para usar la autenticación de Active Directory, la información de los usuarios se importa de Active Directory, y la información sobre la contraseña y el nombre descriptivo presente en el archivo CSV se ignora. Además, si un usuario está especificado en el archivo CSV, pero no existe otro que le corresponda en Active Directory, el usuario no se añade a Tableau Server. Para los usuarios de Active Directory, no se garantiza que el nombre de usuario sea exclusivo en los dominios, por lo que debe incluir el dominio como parte del nombre de usuario. Puede especificarlo de dos formas: domain\username o username@domain.com; sin embargo, le recomendamos que use el formato domain\username. Para obtener más información, consulte Administración de usuarios en implementaciones con almacenes de identidades externos.

Ejemplo

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

tabcmd createusers "users.csv"

Opciones

--admin-type

Obsoleto. Use la opción --role en su lugar.

--[no-]complete

Obsoleto. Comportamiento de error predeterminado: si hay más de 3 errores dentro de un intervalo de diez filas, se producirá un error en el comando.

--no-publisher

Obsoleto. Use la opción --role en su lugar.

--nowait

No espera la finalización de trabajos asíncronos.

--publisher

Obsoleto. Use la opción --role en su lugar.

-r, --role

Especifica un rol en el sitio para los usuarios en el archivo .csv. Si desea asignar roles de sitio mediante la opción --role, cree un archivo .csv independiente para cada rol en el sitio.

Valores válidos: ServerAdministrator, SiteAdministratorCreator, SiteAdministratorExplorer, SiteAdministrator, Creator, ExplorerCanPublish, Publisher, Explorer, Interactor, Viewer y Unlicensed.

En un servidor de varios sitios, el comando no asigna el usuario a un sitio. Por tanto, los únicos roles de sitio que el comando puede asignar correctamente son ServerAdministrator y Unlicensed. Si especifica cualquier otro rol en el sitio, el comando asignará el rol Unlicensed.

En un servidor de un solo sitio, el usuario se crea y se agrega al sitio predeterminado mediante la función que especifique.

Si tiene una instalación de servidor basada en usuarios y el comando crea un usuario nuevo, pero ya ha alcanzado el límite de licencias de sus usuarios, el usuario se agregará como usuario sin licencia.

--silent-progress

No muestra los mensajes de progreso del comando.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

decryptextracts

Descifra todas las extracciones de un sitio. Si no se especifica ningún sitio, se descifran las extracciones del sitio predeterminado. Para obtener más información, consulte Cifrado de extracciones en reposo.

Dependiendo del número y tamaño de las extracciones, esta operación puede consumir importantes recursos del servidor. Considere la posibilidad de ejecutar este comando fuera del horario laboral normal.

Ejemplo

tabcmd decryptextracts "West Coast Sales"

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

delete workbook-name o datasource-name

Elimina el libro de trabajo o la fuente de datos especificados del servidor.

Este comando toma el nombre del libro de trabajo o fuente de datos como está en el servidor, no el nombre de archivo cuando se publicó.

Ejemplo

tabcmd delete "Sales_Analysis"

Opciones

-r, --project

Nombre del proyecto que contiene el libro de trabajo o fuente de datos que desea eliminar. Si no se especifica, se tomará el proyecto “Predeterminado”.

--parent-project-path

Especifica el nombre del proyecto primario para el proyecto anidado según lo indicado con la opción -r. Por ejemplo, para especificar un proyecto denominado "Nested" que existe en un proyecto "Main", use la siguiente sintaxis: --parent-project-path "Main" -r "Nested".

--workbook

El nombre del libro de trabajo que desea eliminar.

--datasource

El nombre de la fuente de datos que desea eliminar.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

deleteextracts

Elimina extracciones para un libro de trabajo o una fuente de datos publicada.

Opciones

-d, --datasource

El nombre de la fuente de datos de destino para eliminar la extracción.

--embedded-datasources

Una lista separada por espacios de nombres de fuentes de datos insertadas dentro del libro de trabajo de destino. Cierre los nombres de las fuentes de datos entre comillas dobles si contienen espacios. Solo está disponible al eliminar extracciones para un libro de trabajo.

--encrypt

Crear una extracción cifrada.

--include-all

Incluir todas las fuentes de datos insertadas en el libro de trabajo de destino.

--parent-project-path

Ruta del proyecto que es la matriz del proyecto que contiene el recurso de destino. Debe especificar el nombre del proyecto con --project.

--project

Nombre del proyecto que contiene el recurso de destino. Solo es necesario si se especifica --workbook o --datasource. Si no se especifica, se utiliza el proyecto "Predeterminado".

-u, -url

El nombre canónico del recurso tal como aparece en la URL.

-w, -workbook

El nombre del libro de trabajo de destino para la eliminación de extracciones.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

deletegroup group-name

Elimina el grupo especificado del servidor.

Ejemplo

tabcmd deletegroup "Development"

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

deleteproject project-name

Elimina el proyecto especificado del servidor.

Con tabcmd, puede especificar únicamente un proyecto de nivel superior en una jerarquía de proyectos. Para automatizar las tareas que desee realizar en un proyecto dentro de un proyecto principal, utilice la llamada API de REST(El enlace se abre en una ventana nueva) de Tableau equivalente.

Ejemplo

tabcmd deleteproject "Designs"

Opción

--parent-project-path

Especifica el nombre del proyecto primario para el proyecto anidado según lo indicado con el comando. Por ejemplo, para especificar un proyecto denominado "Designs" que existe en un proyecto "Main", use la siguiente sintaxis: --parent-project-path "Main" "Designs".

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

deletesite nombre-sitio

Elimina el sitio especificado del servidor.

Ejemplo

tabcmd deletesite "Development"

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

deletesiteusers filename.csv

Elimina usuarios del sitio en el que ha iniciado sesión. Los usuarios que se van a eliminar se especifican en un archivo que contiene una lista simple de un nombre de usuario por línea. (No se necesita más información que el nombre de usuario).

De forma predeterminada, si el servidor solo tiene un sitio o si el usuario pertenece a un único sitio, el usuario también se elimina del servidor. En una instalación de Tableau Server Enterprise, si el servidor contiene varios sitios, los usuarios a los que se les haya asignado el rol en el sitio Administrador de servidor se eliminarán del sitio, pero no del servidor.

Si el usuario es propietario de contenido, su rol cambia a Sin licencia, pero no se elimina del servidor ni del sitio. El contenido sigue siendo propiedad de ese usuario. Para eliminarlo por completo, tiene que cambiar el propietario del contenido y luego volver a eliminar al usuario.

Si el usuario se importó de Active Directory, se elimina del sitio y posiblemente del servidor. Sin embargo, no se elimina de Active Directory.

Ejemplo

tabcmd deletesiteusers "users.csv"

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

deleteusers filename.csv

Elimina a los usuarios indicados en el archivo (.csv) de valores separados por comas especificado.

El archivo .csv debe contener una lista simple de un nombre de usuario por línea.

Ejemplo

tabcmd deleteusers "users.csv"

Opciones

--[no-]complete

Al establecerse como --complete, esta opción requiere que todas las filas sean válidas para que cualquier cambio tenga éxito. Si no se especifica, se usará el parámetro --complete.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

editdomain

Nota: Un buen consejo sería realizar una copia de seguridad de Tableau Server antes de editar el dominio. El dominio se guarda en el repositorio de Tableau y, si se cambia incorrectamente, es posible que los administradores no puedan iniciar sesión.

Cambia el apodo o el nombre de dominio completo de un dominio de Active Directory en el servidor. Un “alias” de dominio es el nombre de dominio NetBIOS de Windows.

Puede modificar el alias de cualquier dominio que use el servidor. En general, puede modificar el nombre de dominio completo de cualquier dominio, excepto el del dominio que use para iniciar sesión. Sin embargo, si el nombre de usuario con el que ha iniciado sesión existe en el dominio actual y en el dominio nuevo, puede modificar el nombre completo del dominio actual.

Para asegurarse de que Tableau Server puede conectarse a otros dominios de Active Directory, también debe especificar los dominios secundarios a los que se conecta Tableau Server estableciendo la opción wgserver.domain.whitelist con TSM. Para obtener más información acerca de los dominios secundarios y la configuración de la conexión, consulte wgserver.domain.whitelist.

Consulte Administración de usuarios en implementaciones con almacenes de identidades externos para saber cómo interactúan con Tableau Server los distintos dominios, el mapeo de nombres de dominio y los nombres de usuario.

Para ver una lista de dominios, use listdomains.

Ejemplos

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

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

Opciones

--id

Id. del dominio que se va a cambiar. Para obtener una lista de Id. de dominio, use listdomains.

--name

Nuevo nombre del dominio.

--nickname

Nuevo alias del dominio.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

editsite site-name

Cambia el nombre de un sitio o el nombre de su carpeta web. También puede usar este comando para permitir o denegar a los administradores de sitio la capacidad de agregar y eliminar usuarios o impedir que estos ejecuten determinadas tareas manualmente. Si los administradores de sitio tienen derechos de administración, podrá especificar cuántos usuarios pueden agregar a un sitio.

Ejemplos

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

Opciones

--site-name

El nombre de sitio que se muestra.

--site-id

Se utiliza en la URL para identificar al sitio de manera exclusiva.

--user-quota

La cantidad máxima de usuarios que pueden ser miembros del sitio.

--[no-]site-mode

Permite o impide que los administradores del sitio agreguen usuarios al sitio.

--status

Si se establece como ACTIVE, activa un sitio; si se establece como SUSPENDED suspende un sitio.

--storage-quota

Cantidad en MB de libros de trabajo, extracciones y fuentes de datos que se pueden almacenar en el sitio.

--extract-encryption-mode

El modo de cifrado de extracciones para el sitio puede ser forzado, habilitado o deshabilitado. Para obtener más información, consulte Cifrado de extracciones en reposo. Dependiendo del número y tamaño de las extracciones, esta operación puede consumir importantes recursos del servidor.

--run-now-enabled

Permita o deniegue a los usuarios la ejecución manual de actualizaciones, flujos o programas de extracciones. Use true para permitir que los usuarios ejecuten tareas manualmente o false para evitar que los usuarios ejecuten tareas manualmente. Para obtener más información, consulte Configuración de Server (general y de personalización).

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

encryptextracts

Cifra todas las extracciones de un sitio. Si no se especifica ningún sitio, se cifran las extracciones del sitio predeterminado. Para obtener más información, consulte Cifrado de extracciones en reposo.

Dependiendo del número y tamaño de las extracciones, esta operación puede consumir importantes recursos del servidor. Considere la posibilidad de ejecutar este comando fuera del horario laboral normal.

Ejemplo

tabcmd encryptextracts "West Coast Sales"

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

export

Exporta una vista o libro de trabajo desde Tableau Server para su almacenamiento en un archivo. Este comando también puede exportar únicamente los datos usados para una vista. Ver datos se exporta en el nivel de resumen. Para exportar datos en el nivel de detalle, debe utilizar la interfaz de usuario de Tableau Server. Para obtener más información, consulte Descargar vistas y libros de trabajo(El enlace se abre en una ventana nueva).

Tenga en cuenta lo siguiente cuando utilice el siguiente comando:

  • Permisos: para poder exportar, deberá disponer del permiso Exportar imagen. De manera predeterminada, todos los roles tienen este permiso Permitido o Heredado; sin embargo, los permisos pueden configurarse por libro de trabajo o vista.

  • Exportar datos: para exportar únicamente los datos de una vista, use la opción --csv. Esto exportará a un archivo .csv los datos de resumen usados en una vista.

  • Especificación de la vista, el libro de trabajo o los datos que se exportarán:

    • Utilice parte de la URL para identificar qué exportar, específicamente la cadena "workbook/view", como aparece en la URL del libro de trabajo o la vista. No use el "nombre descriptivo" y excluya el identificador de sesión :iid=<n> al final de la URL.

      Por ejemplo, la vista de muestra de Tableau Detalles del pedido del libro de trabajo Superstore tiene una URL parecida a esta: <server_name>/#/views/Superstore/OrderDetails?:iid=2

      Para exportar la vista Detalles del pedido, utilice la cadena Superstore/OrderDetails.

      No utilice Superstore/Order Details ni Superstore/OrderDetails?:iid=2.

    • Si el servidor está ejecutando varios sitios y la vista o el libro de trabajo están en un sitio que no es el predeterminado, utilice -t <site_id>.

    • Para exportar un libro de trabajo, obtenga la cadena de la URL abriendo una vista en el libro de trabajo e incluya la vista en la cadena que use.

      En el ejemplo anterior, para exportar el libro de trabajo Superstore, utilice la cadena Superstore/OrderDetails.

    • Para exportar un libro de trabajo, tiene que haberse publicado con la opción Mostrar hojas como pestañas seleccionada en el cuadro de diálogo Publicar de Tableau Desktop.

      Nota: El libro de trabajo de Tableau que contiene el archivo vistas administrativas(El enlace se abre en una ventana nueva) no se puede exportar.

    • Para filtrar los datos que descarga, agregue un filtro de parámetros con este formato:

      ?<filter_name>=value

      O, si el filtrado está en un parámetro y ese parámetro tiene un nombre de visualización que coincide con el nombre de una medida o dimensión:

      ?Parameters.<filter_name>=value

  • El formato del archivo guardado: las opciones de formato dependen de lo que se esté exportando. Un libro de trabajo solamente se puede exportar como PDF con el argumento --fullpdf. Una vista se puede exportar como un archivo PDF (--pdf) o como un archivo PNG (--png).

  • Nombre y ubicación del archivo guardado (opcionales): si no especifica ningún nombre, este se tomará del nombre del libro de trabajo o de la vista. Si no proporciona ninguna ubicación, el archivo se guardará en el directorio en el que está trabajando actualmente. De lo contrario, puede especificar una ruta completa o una asociada al directorio en el que trabaja actualmente.

    Nota: Debe incluir una extensión de nombre de archivo, como .csv o .pdf. El comando no agrega automáticamente una extensión al nombre de archivo que proporcione.

  • Los objetos de la página Web del dashboard no se incluyen en las exportaciones de PDF: de manera opcional, un dashboard puede incluir un objeto de página Web. Si exporta a PDF un dashboard que incluye un objeto de página Web, este último no se incluirá en el PDF.

  • Caracteres ASCII que no son ASCII ni estándares y exportaciones de PDF: si exporta una vista o un libro de trabajo con un nombre en el que se incluye un carácter que no pertenece al conjunto de caracteres ASCII o un conjunto de caracteres ASCII no estándar, necesitará codificar el carácter como URL (o codificación de porcentaje).

    Por ejemplo, si el comando incluye la ciudad de Zürich (Zúrich en inglés), deberá codificarla como Z%C3%BCrich:

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

Borrar la memoria caché para usar datos en tiempo real

De manera opcional, puede agregar el parámetro de URL ?:refresh=yes para forzar una consulta de datos actualizada en lugar de sacar los resultados de la memoria caché. Si utiliza tabcmd con su propio script y se hace un uso intenso del parámetro de URL refresh, esto podría repercutir en el rendimiento. Se recomienda usar refresh solo cuando se requieran datos en tiempo real: por ejemplo, en un dashboard individual en lugar de un libro de trabajo completo.

Ejemplos

Vistas

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

Libros de trabajo

tabcmd export "Q1Sales/Sales_Report" --fullpdf

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

Opciones

-f, --filename

Guarda el archivo con el nombre de archivo y extensión especificados.

--csv

Solo Vista. Permite exportar los datos de la vista (datos de resumen) en formato .csv.

--pdf

Solo Vista. Permite exportar como PDF.

--png

Solo Vista. Permite exportar como imagen en formato .png.

--fullpdf

Solo Libro de trabajo. Permite exportar como PDF. El libro de trabajo debe haberse publicado con la función Mostrar hojas como pestañas habilitada.

--pagelayout

Configura la orientación de página (landscape o portrait) del PDF exportado. Si no se especifica, se utilizará la configuración de Tableau Desktop.

--pagesize

Configura el tamaño de página del PDF exportado de una de las siguientes maneras: unspecified, letter, legal, note folio, tabloid, ledger, statement, executive, a3, a4, a5, b4, b5 o quarto. El valor predeterminado es letter.

--width

Configura el ancho en píxeles. El valor predeterminado es 800 px.

--height

Configura el alto en píxeles. El valor predeterminado es 600 px.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

get url

Obtenga el recurso desde Tableau Server, representado por la URL especificada (parcial). El resultado se indica como un archivo.

Tenga en cuenta lo siguiente cuando utilice el siguiente comando:

  • Permisos: para obtener un archivo, debe disponer del permiso Descargar/Guardar en Web como. De manera predeterminada, todos los roles tienen este permiso Permitido o Heredado; sin embargo, los permisos pueden configurarse por libro de trabajo o vista.

  • Especifique una vista o un libro de trabajo que desee obtener: para especificar que desea obtener una vista, use la cadena "/views/<workbookname>/<viewname>.<extension>" y, para especificar que desea obtener un libro de trabajo, use la cadena "/workbooks/<workbookname>.<extension>". Reemplace <workbookname>  y <viewname> con los nombres de libro de trabajo y de vista como aparecen en la URL al abrir la vista en un navegador y reemplace <extensión> con el tipo de archivo que desee guardar. No use el identificador de sesión al final de la URL (?:iid=<n>) o el nombre "descriptivo" del libro de trabajo o vista.

    Por ejemplo, al abrir la vista Totales regionales de un libro de trabajo llamado Resumen de métricas, la URL será similar a esta:

    /views/MetricsSummary_1/RegionalTotals?:iid=1

    Use la cadena /views/MetricsSummary_1/RegionalTotals.<extension> para obtener la vista.

    Use la cadena /workbooks/MetricsSummary_1.<extension> para obtener el libro de trabajo.

    Al descargar libros de trabajo y vistas desde Tableau Server, el contenido del archivo .twb o .twbx se almacena en texto sin formato. Cualquiera que abra el archivo podrá leer todos los datos, incluidos los valores de filtro que pueden dar pistas semánticas sobre los datos.

  • Extensión del archivo: debe incluirse una extensión de archivo en la dirección URL. La extensión determina lo que se indicará. Una vista se puede devolver en formato PDF, PNG o CSV (solo datos de resumen). Un libro de Tableau se devuelve como TWB si se conecta una fuente de datos publicada o usa una conexión en vivo, o un TWBX si se conecta a una extracción de datos.

    Nota: Si va a descargar una vista en un archivo PDF o PNG y si incluye un parámetro --filename con la extensión .pdf o .png, no tiene que incluir una extensión .pdf o .png en la URL.

  • Nombre y ubicación del archivo guardado (opcionales): El nombre usado para --filename debe incluir la extensión del archivo. Si no proporciona un nombre y una extensión de archivo, ambos se derivarán de la cadena URL. Si no proporciona una ubicación, el archivo se guardará en el directorio en el que está trabajando actualmente. De lo contrario, puede especificar una ruta completa o una asociada al directorio en el que trabaja actualmente.

  • Tamaño PNG (opcional): Si el archivo guardado es un PNG, puede especificar el tamaño, en píxeles, en el URL.

Borrar la memoria caché para usar datos en tiempo real

De manera opcional, puede agregar el parámetro de URL ?:refresh=yes para forzar una consulta de datos actualizada en lugar de sacar los resultados de la memoria caché. Si usa tabcmd con sus propios scripts, mediante el parámetro refresh, puede tener un impacto negativo en el rendimiento. Se recomienda usar refresh solo cuando se requieran datos en tiempo real: por ejemplo, en un dashboard individual en lugar de un libro de trabajo completo.

Ejemplos

Vistas

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

Libros de trabajo

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

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

initialuser

Cree un usuario administrador del servidor que no tenga definido un usuario administrativo inicial. Esto crea un administrador del servidor. Esto no crea un administrador de TSM.

Entrecomille los valores con comillas simples.

Nota: El comando tabcmd initialuser no necesita la autenticación en Tableau Server, pero debe ejecutar el comando en el nodo del servidor inicial.

Notas:

  • El comando tabcmd initialuser no necesita la autenticación en Tableau Server, pero debe ejecutar el comando en el nodo del servidor inicial.
  • El valor username no puede incluir un signo arroba (@) a menos que el sufijo del nombre de usuario coincida con el dominio principal de Tableau Server. Por ejemplo, si Tableau Server se conecta al dominio "myco.com", no se puede utilizar el nombre de usuario "user@example.com@myco.com".

Ejemplos

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

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

Para solicitar la contraseña en el shell, no incluya el parámetro --password en el comando. Por ejemplo:

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

Opciones

-f, --friendly

Crea el usuario administrador inicial del servidor con el nombre para mostrar.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

listdomains

Muestra una lista de dominios de Active Directory en uso en el servidor, además de sus alias e Id. Si el servidor está configurado para usar autenticación local, el comando solo devuelve el nombre de dominio local.

Ejemplo

tabcmd listdomains

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

listsites

Devuelve una lista de sitios a los cuales pertenece el usuario con sesión iniciada.

Ejemplo

tabcmd listsites --username adam --password mypassword

Opciones

--get-extract-encryption-mode

El modo de cifrado de extracciones para el sitio puede ser forzado, habilitado o deshabilitado. Para obtener más información, consulte Cifrado de extracciones en reposo.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

login

Permite al usuario iniciar sesión en Tableau Server.

Use las opciones globales --server, --site, --username, --password para crear una sesión.

Nota: Si usa el comando tabcmd login, no puede utilizar el inicio de sesión único (SSO) de SAML aunque el servidor esté configurado para usar SAML. Para iniciar sesión, debe pasar el nombre de usuario y la contraseña de un usuario que se haya creado en el servidor. Contará con los permisos del usuario de Tableau Server como el que haya iniciado sesión. Para obtener más información, consulte Establecer los roles de sitio de los usuarios y Permisos.

Si desea iniciar sesión con la misma información que ha usado para crear una sesión, simplemente especifique la opción --password. Se usarán el servidor y nombre de usuario almacenados en la cookie.

Si el servidor está usando un puerto que no sea 80 (el predeterminado) deberá especificar el puerto.

Solo necesitará la opción --site (-t) si el servidor ejecuta múltiples sitios e inicia sesión en un sitio distinto al predeterminado. Si no proporciona ninguna contraseña, se le solicitará una. Si se especifica la opción --no-prompt y no se proporciona contraseña, se producirá un error en el comando.

Tras iniciar sesión, esta continuará hasta que expire en el servidor o hasta que se ejecute el comando logout.

Ejemplo

Permite iniciar sesión al usuario jsmith en Tableau Server que se está ejecutando en su máquina local:

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

Permite iniciar sesión al administrador en el sitio Ventas del servidor de ventas:

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

Permite iniciar sesión al administrador en el sitio Ventas en el servidor de ventas usando SSL, pero no valida el certificado SSL del servidor:

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

Establece un puerto y un proxy de reenvío para el host local:

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

Permite iniciar sesión al usuario jsmith en el proxy inverso mediante SSL:

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

Opciones

-s, --server

Si ejecuta el comando desde un equipo con Tableau Server en su red, puede utilizar http://localhost. De lo contrario, especifique la URL del equipo, como http://bigbox.myco.com o http://bigbox.

Si el servidor utiliza SSL, deberá especificarhttps:// en la URL del equipo.

Para Tableau Cloud, especifique la URL completa, incluido el pod en el que se implementa su sitio. Por ejemplo: https://prod-useast-b.online.tableau.com.

-t, --site

Incluya esta opción si el servidor tiene múltiples sitios e inicia sesión en un sitio distinto del predeterminado.

El identificador del sitio se usa en la URL para identificar el sitio de manera exclusiva. Por ejemplo, un sitio llamado Ventas de la costa oeste podría tener el identificador de sitio ventas-costa-oeste.

-u, --username

Nombre de usuario del usuario que inicia sesión. Para Tableau Cloud, el nombre de usuario es la dirección de correo electrónico del usuario.

-p, --password

La contraseña para el usuario especificada para --username. Si no proporciona ninguna contraseña, se le solicitará una.

--password-file

Permite el almacenamiento de la contraseña en el archivo filename.txt determinado en lugar de la línea de comandos para mayor seguridad.

-x, --proxy

Se utiliza para especificar el servidor proxy HTTP y el puerto (Host:Port) de la solicitud de tabcmd.

--no-prompt

No solicita contraseña. Si no se especifica ninguna contraseña, se producirá un error en el comando login.

--no-proxy

No utiliza servidor proxy HTTP.

--cookie

Guarda el identificador de sesión al iniciar sesión. Los comandos subsiguientes no requerirán un inicio de sesión. Este valor es el predeterminado del comando.

--no-cookie

No guarda la información de Id. de sesión tras un inicio de sesión correcto. Los comandos subsiguientes exigirán un inicio de sesión.

--timeout SECONDS

El número de segundos que el servidor debe esperar antes de procesar el comando login. Predeterminado: 30 segundos.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

logout

Cierra la sesión del servidor.

Ejemplo

tabcmd logout

publish nombreDeArchivo.twb(x), nombreDeArchivo.tds(x) o nombreDeArchivo.hyper

Publica el libro de trabajo (.twb(x)), la fuente de datos (.tds(x)) o la extracción (.hyper) especificados en Tableau Server.

Si está publicando un libro de trabajo, de forma predeterminada todas las hojas del mismo se publican sin nombres de usuario ni contraseñas de la base de datos.

Los permisos asignados inicialmente al libro de trabajo o la fuente de datos se copian del proyecto en el que está publicado el archivo. Los permisos del recurso publicado se pueden modificar una vez publicado el archivo. 

Si el libro de trabajo contiene filtros de usuario, es necesario especificar una de las opciones de miniatura.

Ejemplo

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 el archivo no se encuentra en el mismo directorio que tabcmd, incluya la ruta completa del archivo.

Ejemplo

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

Opciones

-n, --name

Nombre de la fuente de datos o libro de trabajo determinado en el servidor. Si se omite, el libro de trabajo, la fuente de datos o la extracción de datos recibirá el nombre del archivo.

-o, --overwrite

Sobrescribe el libro de trabajo, la fuente de datos o la extracción de datos si ya existe en el servidor.

-r, --project

Publica el libro de trabajo, la fuente de datos o la extracción de datos en el proyecto especificado. Publica en el proyecto “Predeterminado”si no se especifica ningún valor.

--parent-project-path

Especifica el nombre del proyecto primario para el proyecto anidado según lo indicado con la opción -r. Por ejemplo, para especificar un proyecto denominado "Nested" que existe en un proyecto "Main", use la siguiente sintaxis: --parent-project-path "Main" -r "Nested".

--db-username

Use esta opción para publicar un nombre de usuario de la base de datos con el libro de trabajo, la fuente de datos o la extracción de datos.

--db-password

Use esta opción para publicar una contraseña de base de datos con el libro de trabajo, la fuente de datos o la extracción.

--save-db-password

Almacena la contraseña de la base de datos proporcionada en el servidor.

--oauth-username

La dirección de correo electrónico de la cuenta de usuario. Conecta al usuario mediante una conexión OAuth preconfigurada si el usuario dispone de un token de acceso guardado para la fuente de datos en nube especificada en --name. Los tokens de acceso se administran en las preferencias de usuario.

Para las conexiones OAuth existentes a la fuente de datos, use esta opción en lugar de --db-username y --db-password.

--save-oauth

Guarda las credenciales especificadas con --oauth-username como credencial incrustada en el libro de trabajo o fuente de datos publicados.

Por consiguiente, cuando el publicador o el administrador del servidor inician sesión en el servidor y editan la conexión del libro de trabajo o la fuente de datos, la configuración de conexión muestra esta credencial OAuth como incrustada en el contenido.

Si desea programar actualizaciones de extracciones tras la publicación, debe incluir esta opción con --oauth-username. Esto equivale a usar el comando --save-db-password con una conexión de base de datos tradicional.

--thumbnail-username

Si el libro de trabajo contiene filtros de usuarios, las miniaturas se generarán según lo que el usuario especificado puede ver. No se puede especificar cuando se establece la opción --thumbnail-group.

--thumbnail-group

Si el libro de trabajo contiene filtros de usuarios, las miniaturas se generarán según lo que el grupo especificado puede ver. No se puede especificar cuando se establece la opción --thumbnail-username.

--tabbed

Cuando se publica un libro de trabajo con vistas tabuladas, cada hoja se convierte en una pestaña que se pueden usar para navegar por el libro de trabajo. Tenga en cuenta que esta configuración anulará cualquier seguridad de nivel de hoja.

--append

Permite agregar el archivo de extracción a la fuente de datos existente.

--replace

Utiliza el archivo de extracción para reemplazar la fuente de datos existente.

--disable-uploader

Permite deshabilitar el cargador de archivos incremental.

--restart

Reinicia la carga del archivo.

--encrypt-extracts

Cifra extracciones cuando se publica un libro de trabajo, una fuente de datos o una extracción en el servidor. Para obtener más información, consulte Cifrado de extracciones en reposo.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

publishsamples

Descripción

Publica los libros de trabajo de muestra de Tableau en el proyecto especificado. Cualquier muestra existente se sobrescribirá.

Sintaxis

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

Ejemplo

Publicar muestras en el proyecto Inside Sales del sitio predeterminado, como usuario jsmith.

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

Opciones

-n, --name

Requerido. Publica las muestras de Tableau en el proyecto especificado. Si el nombre del proyecto incluye espacios, escriba el nombre entre comillas.

--parent-project-path

Especifica el nombre del proyecto primario para el proyecto anidado según lo indicado con la opción -n. Por ejemplo, para especificar un proyecto denominado "Nested" que existe en un proyecto "Main", use la siguiente sintaxis: --parent-project-path "Main" -n "Nested".

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

reencryptextracts

Vuelva a cifrar todas las extracciones de un sitio con nuevas claves de cifrado. Este comando regenerará la clave de cifrado de claves y la clave de cifrado de datos. Debe especificar un sitio. Para obtener más información, consulte Cifrado de extracciones en reposo.

Dependiendo del número y tamaño de las extracciones, esta operación puede consumir importantes recursos del servidor. Considere la posibilidad de ejecutar este comando fuera del horario laboral normal.

Ejemplos

tabcmd reencryptextracts "Default"

tabcmd reencryptextracts "West Coast Sales"

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

refreshextracts workbook-name or datasource-name

Realiza una actualización completa o incremental de las extracciones que pertenecen a la fuente de datos o libro de trabajo especificado.

Este comando toma el nombre del libro de trabajo o fuente de datos como aparece en el servidor, no el nombre de archivo cuando se publicó. Solo un administrador o el propietario del libro de trabajo o fuente de datos tiene permiso para realizar esta operación.

Nota: Este método dará lugar a un error si su Administrador del servidor ha desactivado la configuración de Ejecutar ahora para el sitio. Para obtener más información, consulte Configuración de Tableau Server(El enlace se abre en una ventana nueva).

Ejemplos

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

Opciones

--incremental

Ejecuta la operación de actualización incremental.

--synchronous

Añade la operación de actualización completa a la cola utilizada por el proceso de fondo, para ejecutarse en cuanto haya un proceso de fondo disponible. Si hay un proceso de fondo disponible, la operación se ejecuta de inmediato. La operación de actualización aparece en el informe Tareas de fondo.

Durante una actualización sincronizada, tabcmd mantiene una conexión en tiempo real con el servidor mientras la operación de actualización está en curso, realizando consultas cada segundo hasta que finalice el trabajo de fondo.

Nota: La opción --synchronous no está disponible para las fuentes de datos actualizadas con Tableau Bridge.

--workbook

El nombre del libro de trabajo contiene extracciones para actualizar. Si el libro de trabajo tiene espacios en su nombre, escríbalo entre comillas.

--datasource

El nombre de la fuente de datos contiene extracciones para actualizar.

--project

Utilice este comando con --workbook o --datasource para identificar un libro de trabajo o fuente de datos en un proyecto distinto del Predeterminado. Si no se especifica, se asume el proyecto Predeterminado.

--parent-project-path

Especifica el nombre del proyecto primario para el proyecto anidado según lo indicado con la opción --project.

Por ejemplo:

  • Para especificar un proyecto denominado "Nested" que existe en un proyecto "Main", use la siguiente sintaxis:
  • --parent-project-path "Main" --project "Nested"
  • Para especificar un proyecto denominado "Nested2" que está anidado dentro del proyecto "Nested": 
  • --parent-project-path "Main/Nested" --project "Nested2"

--url

El nombre del libro de trabajo tal como aparece en la URL. Un libro de trabajo publicado como “Análisis de ventas” tendrá el nombre de URL “SalesAnalysis”.

--addcalculations

Úselo con --workbook para materializar cálculos en la extracción incrustada del libro de trabajo o con --datasource a fin de materializar cálculos en la fuente de datos de extracción. Añade la operación a la cola utilizada por el proceso del procesador en segundo plano. Si hay un proceso del procesador en segundo plano disponible, la operación se ejecuta de inmediato. Esta operación aparece en la vista administrativa Tareas de fondo para extracciones .

--removecalculations

Úselo con --workbook o --datasource para eliminar cálculos previamente materializados. Añade la operación a la cola utilizada por el proceso del procesador en segundo plano. Si hay un proceso del procesador en segundo plano disponible, la operación se ejecuta de inmediato. Esta operación aparece en la vista administrativa Tareas de fondo para extracciones .

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

reset_openid_sub

Borra los identificadores (subvalores) de OpenID Connect que ya estén asociados con las identidades de Tableau Server. Consulte Cambiar los IdP en Tableau Server para OpenID Connect.

Ejemplo

tabcmd reset_openid_sub --target-username jsmith

Opciones

--target-username

Borra el subvalor para el usuario individual especificado.

--all

Borra los subvalores de todos los usuarios.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

removeusers group-name

Elimina usuarios del grupo especificado.

Ejemplo

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

Opciones

--users

Permite quitar los usuarios del archivo .csv determinado del grupo especificado. El archivo debe ser una lista simple con un nombre de usuario por línea.

--[no-]complete

Requiere que todas las filas sean válidas para que los cambios se realicen correctamente. Si no se especifica, se usará el parámetro --complete.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

runschedule schedule-name

Ejecuta las tareas en el programa especificado para el sitio en el que está conectado actualmente. No puede ejecutar esto para todos los sitios que usan tabcmd. Para ejecutar las tareas en la programación para todos los sitios, inicie sesión en la interfaz web, desde la página Programas, seleccione Todos los sitios y luego Ejecutar ahora en el programa.

Este comando toma el nombre del programa como está especificado en el servidor.

Este comando no está disponible para Tableau Cloud.

Nota: Este método dará lugar a un error si su Administrador del servidor ha desactivado la configuración de Ejecutar ahora para el sitio. Para obtener más información, consulte Configuración de Tableau Server(El enlace se abre en una ventana nueva).

Ejemplo

tabcmd runschedule "5AM Sales Refresh"

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

set valor

Habilita la configuración especificada en el servidor. En la página Mantenimiento del servidor se pueden ver detalles sobre cada configuración.

Use un signo de exclamación delante del nombre de la configuración para deshabilitar la configuración. Puede habilitar o deshabilitar la configuración siguiente:

  • allow_scheduling

  • embedded_credentials

  • remember_passwords_forever

Ejemplo

tabcmd set embedded_credentials

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

syncgroup group-name

Sincroniza un grupo de Tableau Server con un grupo de Active Directory. Si el grupo de Tableau Server no existe aún, se crea y se sincroniza con el grupo especificado de Active Directory.

Si el nombre del grupo incluye una "@" (que no se utilice para separar dominios), tendrá que hacer referencia al símbolo con el formato hexadecimal "\0x40".

Ejemplo

tabcmd syncgroup "Development"

tabcmd syncgroup "Dev\0x40West"

Nota: Si sincroniza un grupo del que es miembro, los cambios que realice con este comando no se aplican a su usuario. Por ejemplo, si usa este comando para eliminar los derechos de administrador de los usuarios de un grupo del que es miembro, seguirá siendo administrador cuando finalice el comando.

Opciones

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

Especifica si se debe conceder un rol al iniciar sesión. El valor predeterminado es on-sync. Los valores válidos son on-login, on-sync. Si no se especifica ningún valor, se utiliza on-sync y el rol predeterminado se concederá cuando se sincronice el grupo. Para obtener más información, consulte Modificar roles de usuario con Conceder roles al iniciar sesión.

--no-publisher

Obsoleto. Use la opción --role en su lugar.

--overwritesiterole

Permite sobrescribir el rol en el sitio de un usuario con una con menos privilegios al usar --role. De forma predeterminada, el rol en el sitio de un usuario se puede promocionar al usar --role, pero no degradar. Puesto que la opción --overwritesiterole degradará los roles en el sitio de los usuarios, utilícela con cuidado.

--publisher

Obsoleto. Use la opción --role en su lugar.

-r, --role

Especifica un rol en el sitio para los usuarios del grupo. El valor predeterminado es Unlicensed.

Valores válidos: SiteAdministratorCreator, SiteAdministratorExplorer, SiteAdministrator, Creator, ExplorerCanPublish, Publisher, Explorer, Interactor, Viewer, Unlicensed.

--silent-progress

No muestra los mensajes de progreso del comando.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

upgradethumbnails

Inicia y detiene el trabajo Actualizar miniaturas. Para obtener más información, consulte Trabajo Actualización de miniaturas.

Ejemplos

Para iniciar el trabajo Actualizar miniaturas:

tabcmd upgradethumbnails --server <serverURL>

Para detener el trabajo Actualizar miniaturas en curso:

tabcmd upgradethumbnails --server <serverURL> --stop

Opciones

--stop

Cuando se especifica, detiene el trabajo Actualizar miniaturas en curso. Si no se especifica esta opción, se iniciará el trabajo Actualizar miniaturas.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

validateidpmetadata

Identifica los sitios de Tableau Server que están configurados con IdP mediante el algoritmo de resumen inseguro SHA-1. Este comando también identifica a los IdP que utilizan certificados con un tamaño de clave RSA o un tamaño de curva elíptica insuficientes.

Nota: Este comando solo está disponible para SAML específico del sitio. Para obtener más información, consulte Configurar SAML específico de un sitio.

Opciones

--digest-algorithms <ALGORITHMS>

Una lista de algoritmos de resumen separados por espacios. Los valores legales sonsha1 ysha256. Si no se especifica, el servidor usa valores de la configuración del servidor, wgserver.saml.blocklisted_digest_algorithms.

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

Si no se especifica, el servidor utiliza los valores de la configuración del servidor, wgserver.saml.min_allowed.elliptic_curve_size.

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

Si no se especifica, el servidor usa los valores de la configuración del servidor, wgserver.saml.min_allowed.rsa_key_size.

--site-names <SITENAMES>

Una lista de nombres de sitios separados por espacios en los que realizar la validación del certificado. Si no se especifica, se inspeccionan todos los sitios.

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

version

Muestra la información de versión de la instalación actual de la utilidad tabcmd.

Ejemplo

tabcmd version

Opciones globales

Las opciones siguientes las usan todos los comandos tabcmd. Las opciones --server, --user y --password se requieren al menos una vez para comenzar una sesión. Se almacena un token de autenticación de forma que se puedan ejecutar comandos posteriores sin incluir estas opciones. Este token permanece válido durante cinco minutos después del último comando que lo usó.

-h, --help

Muestra la ayuda para el comando.

-c, --use-certificate

Usa el certificado del cliente para iniciar sesión. Se requiere cuando SSL mutua está habilitada.

Si desea información sobre la configuración del certificado, empiece por el tema que corresponda al sistema operativo de su Tableau Server:

-s, --server

La URL de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-u, --user

El nombre de usuario de Tableau Server, que se requiere al menos una vez para iniciar sesión.

-p, --password

La contraseña de Tableau Server, que se requiere al menos una vez para iniciar sesión.

--password-file

Permite el almacenamiento de la contraseña en el archivo .txt dado en lugar de en la línea de comandos para mayor seguridad.

-t, --site

Indica que el comando se refiere al sitio especificado en el identificador del sitio de Tableau Server, entre comillas simples o dobles. Para especificar el sitio Predeterminado, utilice una cadena vacía con comillas simples o dobles ('' o "") o utilice Predeterminado entre comillas dobles ("Predeterminado"). El ID del sitio distingue entre mayúsculas y minúsculas cuando se utiliza un token de autenticación en caché. Si no distingue entre mayúsculas y minúsculas, es posible que se le pida una contraseña, incluso si el token sigue siendo válido.

-x, --proxy

Host:Port

Usa el proxy HTTP especificado.

--no-prompt

Cuando se especifica, el comando no solicita una contraseña. Si no se proporcionó una contraseña válida, el comando fallará.

--no-proxy

Cuando se especifica, no se usa un proxy HTTP.

--no-certcheck

Cuando se especifica, tabcmd (el cliente) no valida el certificado SSL del servidor.

--[no-]cookie

Cuando se especifica, el identificador de sesión se guarda al iniciar sesión para que los comandos posteriores no requieran que se inicie sesión. Use el prefijo no- para no guardar el identificador de sesión. La sesión se guarda de manera predeterminada.

--timeout

Espera el número de segundos especificado para que el servidor finalice el procesamiento del comando. De forma predeterminada, el proceso esperará hasta que el servidor responda.

--

Especifica el final de las opciones de la línea de comandos. Puede usar -- para indicar a tabcmd que todo lo que vaya después de -- no se debe interpretar como una opción de configuración, sino que se puede interpretar como un valor del comando. Es útil si tiene que especificar un valor en el comando que incluye un guion. En el ejemplo siguiente se muestra cómo usar -- en un comando tabcmd, donde -430105/Sheet1 es un valor obligatorio para el comando export.

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

Sugerencia: Para ver los comandos de Tabcmd 1.0 disponibles para Tableau Cloud, consulte Comandos de tabcmd(El enlace se abre en una ventana nueva).
¡Gracias por sus comentarios!Sus comentarios se han enviado correctamente. ¡Gracias!