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:
- seleção automática de qualidade
- otimizar a qualidade
- otimizar a velocidade
- opções customizadas
- 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
teamviewer.exe -i <ID> -P <Password>
- Transferência de arquivo:
teamviewer.exe -i <ID> -P <Password> -m fileTransfer
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:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment <options>
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: false
Concede acesso fácil após a atribuição (igual à opção "Grant easy access" na janela principal do TeamViewer)
_______________________________________________________________________________________
reassign
DEFAULT VALUE: false
Atribui o dispositivo à conta mesmo que o dispositivo já esteja atribuído a uma conta.
_______________________________________________________________________________________
wait
DEFAULT VALUE: 10
Tempo 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>
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