---
schema_version: "1"
id: a8dd1cdb14d9ca7f2f21c59e1aef2d61c8d888fc3ff6da99e8f86ee23dd1eaf4
title: Referência da linha de comando tsm
collection: tableau
version: current
locale: pt-br
portal_url: https://docs.salesforce.com/tableau/current/pt-br/server-linux/tsm.md
canonical_url: https://help.tableau.com/current/server-linux/pt-br/tsm.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 7ecf62d896d6a2f316d930acd70be8fbc932015b46d898563f6264f6815134d4
description: Reference for the Tableau Services Manager (TSM) command line interface.
---
[Pular para o conteúdo principal](#main-content)

# Referência da linha de comando tsm

Os tópicos desta seção incluem o conteúdo de referência da interface de linha de comandos (CLI) do Tableau Services Manager (TSM) para suportar o Tableau Server .

O TSM é usado para gerenciar a instalação e a configuração do Tableau Server. Para saber mais sobre o TSM, consulte [Visão geral do Tableau Services Manager](https://help.tableau.com/current/server-linux/pt-br/tsm_overview.htm).

É possível automatizar as tarefas de instalação e configuração suportadas pelo TSM CLI usando a API do TSM. Para saber mais sobre a API do TSM de pré-versão (Alpha), consulte [API do Tableau Services Manager](https://help.tableau.com/v0.0/api/tsm_api/pt-br/index.htm).

Procurando por comandos tsm para Tableau Server no Windows? Consulte [Comandos tsm](https://help.tableau.com/current/server/pt-br/tsm.htm "Abre o tópico em uma nova guia do navegador").

## Uso da CLI do tsm

Você pode executar comandos tsm no nó inicial (o nó onde o TSM está instalado) ou em qualquer nó adicional no cluster.

Para executar comandos tsm, é necessário abrir um prompt de comando.

1. Abra um prompt de comando com uma conta que seja membro do grupo `tsmadmin` em um nó no cluster.
2. Execute o comando desejado. Se você estiver executando o comando de um nó diferente do nó inicial, inclua a opção `-s` para especificar a URL do nó inicial por nome (não por endereço IP) e inclua a porta do TSM, 8850.
    
    Para ver a versão do TSM e do Tableau Server no nó inicial:
    
    `tsm version`
    
    Para ver a versão do TSM e do Tableau Server de um nó adicional:
    
    `tsm version -s https://<inital_node_name>:8850`
    
    Por exemplo:
    
    `tsm version -s https://myTableauHost:8850`

## Autenticação com a CLI tsm

A partir da versão 2019.2 do Tableau Server, a execução de comandos tsm não exigirá que você insira uma senha se a seguinte for verdadeiro:

- A conta com a qual você está executando comandos é membro do grupo autorizado pelo TSM, por padrão, o grupo. `tsmadmin` O usuário do Tableau sem privilégios (por padrão, o usuário `tableau`) e a conta raiz também podem executar comandos do TSM.
- Você está executando comandos localmente no Tableau Server que está executando o serviço do controlador de administração do Tableau Server. Por padrão, o serviço do controlador de administração do Tableau Server é instalado e configurado no nó inicial em uma implantação distribuída.

### Fazer logon na CLI tsm localmente

Se estiver executando comandos tsm no computador local com a conta de usuário que é membro de um grupo autorizado pelo TSM, você não precisará especificar uma senha. Neste caso, apenas execute o comando, por exemplo:

`tsm version`

### Fazer logon na CLI tsm remotamente

Se estiver executando comandos do TSM em um nó em um cluster em que o serviço do controlador de administração do Tableau Server não estiver em execução, você deverá autenticar uma sessão com o serviço do controlador de administração do Tableau Server no computador remoto antes de executar comandos. Por exemplo, execute o comando a seguir:

`tsm login -s <server_name> -u <account_name>`

Em que `<server_name>` é o nome do nó em que o serviço do controlador de administração do Tableau Server está sendo executado e `<account_name>` é uma conta membro de um grupo autorizado pelo TSM.

Após executar este comando, você será solicitado a fornecer uma senha. Depois que a conta for autenticada, você poderá executar os comandos do TSM.

Como prática recomendada de segurança, não exponha a porta TSM (por padrão, `8850`) para a internet.

### Exibir e adicionar contas ao grupo autorizado pelo TSM

O grupo autorizado pelo TSM é criado durante a instalação do servidor. Por padrão, o grupo autorizado pelo TSM é chamado `tsmadmin`. Se você criou um grupo autorizado pelo TSM alternativo durante a instalação, substitua o nome do grupo por `tsmadmin` nos seguintes exemplos de código.

Para visualizar as contas do usuário no grupo `tsmadmin`, execute o comando a seguir:

`grep tsmadmin /etc/group`

Para adicionar uma conta de usuário ao grupo `tsmadmin`:

`sudo usermod -G tsmadmin -a <username>`

## Script e automação com a CLI tsm

Para executar a automação em um Tableau Server sem uma senha no arquivo de script, execute o script no nó inicial e com uma conta no grupo autorizado pelo TSM. Consulte a seção "Autenticação" acima para obter mais detalhes.

## Exibição do conteúdo de ajuda no shell

Para visualizar o conteúdo de ajuda mínimo de uma linha de comando, use a categoria `tsm help`.

### Sinopse

`tsm help [category] [command]`

### Comandos

`tsm help`

Ajuda de todos os comandos tsm

`tsm help <category>`

Mostra a ajuda de uma categoria de comandos específica. Por exemplo, `tsm help authentication`.

`tsm help <category> <command>`

Mostra a ajuda de um comando específico. Por exemplo, `tsm help authentication open-id`.

`tsm help commands`

Lista todos os comandos ou as categorias de nível superior.

## Categorias

## Outros artigos nesta seção