A versão completa do TeamViewer no Windows pode executar parâmetros de linha de comando que iniciam uma sessão em um dispositivo remoto usando um ID, senha e modo de conexão predefinidos.

Você pode usar esses parâmetros para executar o TeamViewer a partir do prompt de comando, de um script (por exemplo, um arquivo .bat) ou de um atalho na área de trabalho ou no menu Iniciar.

Este artigo se aplica a usuários do TeamViewer com Windows ou macOS.

Como usar parâmetros de linha de comando

Parâmetros com e sem valor

📌Lembrete: Alguns parâmetros estão disponíveis apenas com o TeamViewer versão 13.2.

Existem dois tipos de parâmetros, com valor e sem valor.

Exemplo para um parâmetro sem valor: 

TeamViewer.exe --noInstallation

Exemplo para um parâmetro com valor: 

TeamViewer.exe --id 123456789

Na maioria dos casos, apenas um valor é esperado, se vários forem fornecidos, apenas o primeiro será usado.

Se o valor de um parâmetro contém um espaço, o valor deverá ser colocado entre aspas " ".

📌Lembretes:

  • Um parâmetro longo é chamado assim (com dois “-“ - “--“): TeamViewer.exe --Minimize
  • Se o parâmetro tiver uma variante curta, também pode ser chamado com apenas um “-“: TeamViewer.exe -n
  • No entanto, o uso de “--n” também é possível em algumas plataformas. Vários parâmetros podem ser combinados em uma chamada e os parâmetros diferenciam maiúsculas de minúsculas.

Aplicação

As seguintes opções são suportadas:

(Encontre o parâmetro e a variante curta na primeira linha, com a descrição de cada um abaixo.)

Minimize

Inicie o TeamViewer minimizado. Se 'Iniciar TV com janelas' estiver ativado, o TeamViewer será iniciado na bandeja

_______________________________________________________________________________________

id - i

Inicia uma conexão com um determinado ID de parceiro

_______________________________________________________________________________________

Password - p

Usado em combinação com 'id'. Senha a ser usada para a conexão

_______________________________________________________________________________________

PasswordB64 - B

Usado em combinação com 'id'. Senha criptografada Base64 a ser usada para a conexão.

_______________________________________________________________________________________

mode - m

Usado em combinação com 'id'. Modo de conexão a ser usado para a conexão.

Se omitido, o controle remoto é usado.

Valores suportados:

  • transferência de arquivo
  • vpn

Exemplo: --mode fileTransfer

_______________________________________________________________________________________

quality - q

Usado em combinação com 'id'. Configuração de qualidade de conexão a ser usada para a conexão

Valores suportados:

  1. seleção automática de qualidade
  2. otimizar a qualidade
  3. otimizar a velocidade
  4. opções customizadas
  5. Indefinido

Exemplo:--quality2

_______________________________________________________________________________________

ac - a

Usado em combinação com 'id'. Direitos de controle de acesso a serem usados ​​para a conexão (de saída).

Valores suportados:

0. acesso total

  • confirme tudo
  • ver e mostrar
  • personalizadas

📌Lembrete: Ao usar o parâmetro personalizado, os valores de controle de acesso de saída personalizados anteriores serão aplicados.

9. indefinido

Exemplo:  --ac1

_______________________________________________________________________________________

play

Reproduza um arquivo de sessão do TeamViewer (*.tvs)

Exemplo: TeamViewer.exe --play C:Users\shvarts\Desktop\A\abc.tvs

_______________________________________________________________________________________

control

Inicie uma conexão (RC/Meeting) com um id especificado no arquivo de controle fornecido (*.tvc)

Onde encontrar arquivos .tvc:

  • %appdata%\TeamViewer\MRU\RemoteSupport
  • %appdata%\TeamViewer\MRU\Meeting

Exemplo: TeamViewer.exe --control C:\Users\shvarts\Desktop\A\abc.tvc

_______________________________________________________________________________________

ProxyIP

Proxy IP e porta, formatados como: IPAddress:Port

Exemplo: TeamViewer.exe --ProxyIP 192.168.0.2:8080

_______________________________________________________________________________________

ProxyUser

Usado em combinação com 'ProxyIP'. Nome de usuário proxy

Exemplo: TeamViewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin

_______________________________________________________________________________________

ProxyPassword

Usado em combinação com 'ProxyIP'. Senha Proxy Base64 codificada.

Exemplo: TeamViewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin --ProxyPassword test

_______________________________________________________________________________________

sendto

Envie uma lista de arquivos para um parceiro em sua lista de parceiros. Podem ser abertos prompts para login e seleção de destinatário.

Exemplos:

Único arquivo: TeamViewer.exe --Sendto C:\Users\shvarts\Desktop\A\abc.jpg

Vários arquivos: TeamViewer.exe --Sendto C:\Users\shvarts\Desktop\A\abc.jpg C:\Users\shvarts\Desktop\A\abcd.jpg

_______________________________________________________________________________________

Exemplos

  • Controle remoto:
teamviewer.exe -i <ID> -P <Password> 
  • Transferência de arquivo:
teamviewer.exe -i <ID> -P <Password> -m fileTransfer 
  • VPN: 
teamviewer.exe -i <ID> -P <Password> -m vpn 

Atribuição de dispositivo (Legado)

Windows

No Windows, a tarefa de atribuição é iniciada assim:

TeamViewer.exe assign <options>

 

macOS,

No macOS, é iniciado assim:

  • Versão do Host: 
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment <options>
  •  Versão completa:
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment <options>

 "sudo" é necessário para obter direitos de administrador porque AssignmentData.json é escrito com direitos restritos por TeamViewer_Service. A ferramenta só pode ser executada a partir do pacote de aplicativos; caso contrário, a ferramenta não poderá encontrar suas estruturas necessárias.

Se o valor (por exemplo, grupo) contiver um espaço, o valor deve ser colocado entre "" ou cada espaço deve ser encapsulado com "\" no macOS.

Use “--” para Windows na frente de cada opção e “-“ para macOS na frente de cada opção.

Parâmetros

Encontre cada opção e sua descrição abaixo.

As seguintes opções são suportadas:

api-token (OBRIGATÓRIO)

Token necessário para acessar a API, que pode ser gerado no Management Console (por exemplo, em "configurações de perfil/aplicativos"). Tokens para a implantação de Hosts personalizados também podem ser usados.

_______________________________________________________________________________________

alias

Alias ​​para o novo dispositivo na lista de computadores e contatos. Se o dispositivo já estiver na lista de contatos, nenhum alias será aplicado

_______________________________________________________________________________________

grant-easy-access

DEFAULT VALUE: falseConcede acesso fácil após a atribuição (igual à opção "Grant easy access" na janela principal do TeamViewer)

_______________________________________________________________________________________

reassign

DEFAULT VALUE: falseAtribui o dispositivo à conta mesmo que o dispositivo já esteja atribuído a uma conta.

_______________________________________________________________________________________

wait

DEFAULT VALUE: 10Tempo de espera em segundos para que a atribuição aguarde a criação do arquivo de dados. Normalmente, o valor padrão é suficiente.

_______________________________________________________________________________________

group

Necessário apenas se nenhum Host personalizado for usado, pois o grupo já está definido na configuração personalizada. Nome do grupo no qual o dispositivo será adicionado. Caso o grupo não exista, ele será criado automaticamente. Se o dispositivo já estiver presente na lista de computadores e contatos em um grupo diferente, ele não será movido para o grupo.

_______________________________________________________________________________________

group-id

Alternativa ao  --group parâmetro se o id do grupo for conhecido. Pode ser útil para ambientes de clientes maiores, pois acelera o processo de atribuição.

Normalmente, o uso  --group é suficiente

_______________________________________________________________________________________

proxy

URL do seu proxy no formato <nome>:<porta>,

Exemplo: --proxy yourproxy:3201

_______________________________________________________________________________________

proxy-user

O nome de usuário usado para autenticação no proxy

_______________________________________________________________________________________

proxy-pw

Senha usada para autenticação no proxy

_______________________________________________________________________________________

proxy-pwbase64

O mesmo que,  --proxy-pw mas a senha precisa ser inserida como uma string codificada em Base64.

_______________________________________________________________________________________

verbose

Necessário apenas para macOS.  Ele pode ser usado para permitir um registro mais detalhado. Usado apenas em casos de análise de erros.

_______________________________________________________________________________________

retries

A atribuição é repetida em caso de erros temporários. Observe que há um tempo de espera de 1 segundo entre cada tentativa.

_______________________________________________________________________________________

timeout

Defina o tempo limite geral em segundos usado para todas as tentativas de atribuição.

_______________________________________________________________________________________

Exemplos:

Windows

Tarefa básica:

TeamViewer.exe assign --api-token 12345678 --group SomeGroup

 Usando um alias e concedendo acesso fácil:

TeamViewer.exe assign --api-token 12345678 --group "Some Group" --alias %COMPUTERNAME% --grant-easy-access

 Usando um proxy com autenticação:

TeamViewer.exe assign --api-token 12345678 --group SomeGroup --reassign --proxy testproxy:3201 --proxy-user someuser --proxy-pw passwd

Mac OS

📌Lembretes:

Os exemplos são para a versão Host. Para a versão completa, substitua TeamViewerHost.app por TeamViewer.app)

 Tarefa básica:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token 12345678 -group SomeGroup

 Usando um alias e concedendo acesso fácil:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token 12345678 -group "Some Group" -alias $USER -grant-easy-access 

 Usando um proxy com autenticação:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token 12345678 -group Some

Atribuição de dispositivo (Novo)

Para implantação em massa no TeamViewer versão 15 e superior, recomendamos usar os novos parâmetros de linha de comando - você pode encontrar mais informações em nossa Base de Conhecimento: Atribuir um dispositivo via linha de comando - 8/9

COM API

No Windows, a COM API pode ser usada assim:

TeamViewer .exe api <options>

Opção Descrição Versão do TeamViewer

--install

Instala o COM API

> = 11

--uninstall

Desinstala o COM API

> = 11

Como verificar a instalação bem-sucedida

Via arquivo de log

Abra o arquivo TV logfile from %appdata%\TeamViewer e encontre as seguintes entradas:

CommandLineTasks: initializing...

CommandLineTasks: installing COM-API

API: Installing API ...

API: ... successfully installed, calling SignalServiceParamChange ...

API: ... SignalServiceParamChange finished

CommandLineTasks: installing COM-API successful

CommandLineTasks: finished

Através do Windows Powershell

Use os seguintes comandos do Powershell:

$tv = new-object -com TeamViewer.Application
$tv.ApiVersion

Verifique se qualquer versão será gravada no Windows Powershell, por exemplo:

Como verificar a desinstalação bem-sucedida

Via arquivo de log

Abra o arquivo TV logfile from %appdata%\TeamViewer e encontre as seguintes entradas:

CommandLineTasks: initializing...

CommandLineTasks: uninstalling COM-API

API: Uninstalling API ...

API: ... successfully uninstalled, calling SignalServiceParamChange ...

API: ... SignalServiceParamChange finished

CommandLineTasks: uninstalling COM-API successful

CommandLineTasks: finished

Através do Windows Powershell

Use os seguintes comandos do Powershell:

$tv = new-object -com TeamViewer.Application

Verifique se um erro será impresso no Powershell