--- schema_version: "1" id: bc458e894104e27031ad4891d97fffc9ba8369a7efe3b6b6f2b0d20754d48d75 title: tabcmd collection: tableau version: current locale: pt-br portal_url: https://docs.salesforce.com/tableau/current/pt-br/online/tabcmd.md canonical_url: https://help.tableau.com/current/online/pt-br/tabcmd.htm source_site: help.tableau.com content_type: documentation content_hash: cb8eb929b55b5f80e04c0452a622e37eaf6f87c848930b7caa6bf316e9d19f2a description: Install and use the tabcmd command-line utility for Tableau. --- [Pular para o conteúdo principal](#main-content) # tabcmd **Importante:** entre agosto de 2024 e março de 2025, os sites do Tableau Cloud foram migrados para o [Hyperforce](https://help.salesforce.com/s/articleView?id=000388902&type=1) do Salesforce. Como resultado da migração, o tabcmd 1.0 não é mais compatível. Planeje sua migração para o tabcmd 2.0 o mais rápido possível para garantir que você não será afetado. Essa descontinuação não afeta o Tableau Server. **Observação:** na maioria dos casos, você deve usar o utilitário de linha de comando tabcmd 2.0 (tabcmd 2.0) com o Tableau Cloud. Tabcmd 2.0 está disponível em [Tabcmd do Tableau](https://tableau.github.io/tabcmd). Esta nova versão permite: executar comandos tabcmd em MacOS e Linux, autenticar usando tokens de acesso pessoal (PATs) e permitir que você seja compatível com autenticação multifator (MFA). A versão 2.0 é baseada em endpoints públicos disponíveis no Tableau Server Client (TSC) baseado em Python. O Tableau fornece o utilitário de linha de comando tabcmd que pode ser usado para automatizar tarefas de administração do site no seu site do Tableau Cloud. Por exemplo, criar ou excluir usuários, projetos e grupos. **Importante:** o tabcmd 1.0 não oferece suporte à autenticação multifator (MFA). Para usar o tabcmd com o Tableau Cloud, use o [Tableau tabcmd 2.0](https://tableau.github.io/tabcmd) (nova janela). Para obter mais informações sobre o Tableau Cloud e a MFA, consulte [Autenticação multifator e o Tableau Cloud](https://help.tableau.com/current/online/pt-br/to_security_mfa.htm). ## Instalar tabcmd **Observação:** estas instruções são para instalar o utilitário de linha de comando tabcmd 1.0. Para instalar o utilitário de linha de comando tabcmd 2.0, vá para [Tableau tabcmd](https://tableau.github.io/tabcmd) (nova janela). Ao atualizar o Tableau Server ou o Tableau Cloud para uma nova versão, se uma versão atualizada do tabcmd for exigida, é possível baixá-la da página de Versões do Tableau _Server_, no site do Tableau. Para o Tableau Server , recomendamos que você baixe a versão que corresponde à versão do seu servidor. Para o Tableau Cloud, recomendamos que você sempre baixe a versão mais recente para evitar problemas causados por incompatibilidades de versão. Em ambos os casos, usar uma versão desatualizada do tabcmd pode causar erros e resultados imprevisíveis. 1. Abra um navegador da Web e vá para a página [Versões do Tableau Server.](https://www.tableau.com/pt-br/support/releases/server) Acesse esta página mesmo que você use o Tableau Online. 2. Se você estiver usando: - **Tableau Cloud**, use o [Tableau tabcmd 2.0](https://tableau.github.io/tabcmd) (nova janela). - **O Tableau Server (Windows ou Linux):** selecione a versão que corresponde à versão do seu servidor. Em ambos os casos, se as informações expandidas mostrarem as versões de manutenção, selecione a mais recente ou a que corresponde à versão de seu servidor. ![Selecione a versão do servidor que você usa (versão mais recente do Tableau Cloud)](/tableau/current/pt-br/online/pt-br/Img/tabcmd_download1.png) Você será redirecionado à página de notas de versão, chamada Problemas resolvidos, onde poderá ler sobre as melhorias de segurança e os problemas resolvidos. 3. Nos problemas resolvidos, navegue até a seção **Baixar arquivos** e selecione o link de download do tabcmd compatível com o computador no qual você executará os comandos.  ![Selecione o instalador tabcmd para o computador em que você o usará (32 ou 64 bits)](/tableau/current/pt-br/online/pt-br/Img/tabcmd_download.png) As etapas restantes se referem a este computador como "o computador do tabcmd”. 4. Salve o instalador no computador do tabcmd ou em uma localização acessível a partir daquele computador . 5. Conclua as etapas de instalação como adequado para o sistema operacional do computador do tabcmd. - Windows Por padrão, tabcmd é instalado em `C:\Program Files\Tableau\Tableau Server\\extras\Command Line Utility`. É possível alterar isso durante a instalação e recomendar a instalação do tabcmd em uma pasta chamada `tabcmd` na raiz da unidade C:\\ (`C:\tabcmd`). Isso pode facilitar a localização e a execução e acomodará algumas limitações com o sistema operacional Windows, se você adicionar o diretório tabcmd ao Windows PATH. **Observação:** o programa de instalação do tabcmd não adiciona o diretório tabcmd à variável PATH do Windows. Você pode adicionar manualmente, ou incluir o caminho completo para tabcmd sempre que chamá-lo. É possível instalar o tabcmd de duas maneiras no Windows: - Clique duas vezes no instalador para seguir as etapas na interface do usuário: 1. Aceite o contrato de licença. 2. Se você quiser instalar em um local não padrão, clique em Personalizar e digite ou navegue até o local em que deseja instalar o tabcmd. 3. Clique em Instalar. Se o prompt do Windows Defender Firewall ou Controle de conta do usuário for exibido, clique em **Permitir acesso**. - Execute o instalador no prompt de comando: 1. Abra um prompt de comando como um administrador no computador do tabcmd. 2. Navegue até o diretório onde você copiou o instalador do tabcmd. 3. Instale o tabcmd: tableau-setup-tabcmd-tableau--x64.exe /quiet ACCEPTEULA=1 Para instalar em um local não padrão: tableau-setup-tabcmd-tableau--x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="" Por exemplo: tableau-setup-tabcmd-tableau--x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="C:\\tabcmd" Para obter uma lista completa das opções da linha de comando que você pode usar com o instalador do tabcmd, execute o instalador com um /?. Para obter mais informações sobre as opções da linha de comando do instalador do tabcmd, consulte [Instalar switches e propriedades do tabcmd (Windows)](https://help.tableau.com/current/online/pt-br/tabcmd_install_flags.htm). O programa de Configuração do tabcmd cria registros em `C:\Users\\AppData\Local\Temp` que você pode usar, se tiver problemas para instalar o tabcmd. Os registros usam a convenção de nomenclatura `Tableau_Server_Command_Line_Utility_()_##############.log`. - Linux **Observação:** para executar o tabcmd em um computador Linux, você deve instalar o Java 11. Em sistemas semelhantes ao RHEL, ele será instalado como uma dependência ao instalar o tabcmd. Em sistemas Ubuntu, você precisa instalar o Java 11 separadamente, se ele ainda não estiver instalado. A partir de julho de 2022, as distribuições Debian não são mais aceitas. Para obter mais informações, consulte a [postagem da Comunidade do Tableau](https://community.tableau.com/s/news/a0A4T0000011xDOUAY/debian-end-of-life). 1. Faça logon como um usuário com acesso sudo ao computador do tabcmd. 2. Navegue até o diretório onde você copiou o pacote de `.rpm` ou `.deb` baixado. - Em distribuições em RHEL, incluindo o CentOS, execute o comando a seguir: `sudo yum install tableau-tabcmd-.noarch.rpm` - Em Ubuntu, execute o seguinte comando: `sudo apt-get install ./tableau-tabcmd-_all.deb` Para desinstalar o tabcmd de um computador Linux, consulte a documentação da variedade Linux que você está executando. 6. (Opcional) Adicione o local totalmente qualificado onde o tabcmd está instalado no caminho do sistema para permitir que você execute comandos tabcmd sem alterar para esse local ou especificar o local com cada comando. As etapas para fazer isso dependem do tipo e da versão do sistema operacional. Para obter mais informações, consulte [PATH\_(variável)](https://pt.wikipedia.org/wiki/PATH_\(variável\)). ## Como usar o tabcmd As etapas básicas para usar o tabcmd são as seguintes: 1. Abra o prompt de comando como um administrador. **Observação:** não use o PowerShell para executar comandos tabcmd no Windows. O uso do PowerShell pode causar um comportamento inesperado. 2. Em um computador com Windows, se o tabcmd foi instalado em um computador que não seja o nó inicial, altere para o diretório em que o tabcmd foi instalado. Em um computador com Linux, não é necessário mudar para o diretório de instalação. 3. Execute o comando tabcmd. Ao usar o tabcmd, você deve estabelecer uma sessão de servidor autenticado. A sessão identifica o site do servidor ou do Tableau Cloud e o usuário que a executa. Você pode iniciar uma sessão primeiro e especificar seu comando em seguida, ou você pode iniciar uma sessão e executar o comando de uma vez. **Importante:** caso esteja usando o tabcmd para executar mais de uma tarefa, você deve executar uma tarefa após a outra (em série), em vez de ao mesmo tempo (em paralelo). Os comandos (como `login`) e as opções (como `-s`, `-u`, etc.) não diferenciam maiúsculas de minúsculas, mas os valores fornecidos por você (como `User@Example.com`) diferenciam maiúsculas de minúsculas. ## Exemplos O comando a seguir demonstra como iniciar uma sessão: `tabcmd login -s https://prod-useast-b.online.tableau.com -t mysite -u authority@email.com -p password` Confira aqui como iniciar uma sessão e excluir uma pasta de trabalho com um comando; observe que não é preciso usar `login` aqui: `tabcmd delete "Sales_Workbook" -s https://prod-useast-b.online.tableau.com -t campaign -u admin@email.com -p password` As opções `-s`, `-t`, `-u`, e `-p` estão entre as variáveis globais do tabcmd, que podem ser usadas com qualquer comando. Para obter mais informações, consulte [Comandos tabcmd](https://help.tableau.com/current/online/pt-br/tabcmd_cmd.htm).