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.
📌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.
TeamViewer.exe --noInstallation
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:
TeamViewer.exe --Minimize
TeamViewer.exe -n
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.)
Inicie o TeamViewer minimizado. Se 'Iniciar TV com janelas' estiver ativado, o TeamViewer será iniciado na bandeja
_______________________________________________________________________________________
Inicia uma conexão com um determinado ID de parceiro
_______________________________________________________________________________________
Usado em combinação com 'id'. Senha a ser usada para a conexão
_______________________________________________________________________________________
Usado em combinação com 'id'. Senha criptografada Base64 a ser usada para a conexão.
_______________________________________________________________________________________
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:
Exemplo: --mode fileTransfer
_______________________________________________________________________________________
Usado em combinação com 'id'. Configuração de qualidade de conexão a ser usada para a conexão
Exemplo:--quality2
_______________________________________________________________________________________
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
📌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
_______________________________________________________________________________________
Reproduza um arquivo de sessão do TeamViewer (*.tvs)
Exemplo: TeamViewer.exe --play C:Users\shvarts\Desktop\A\abc.tvs
_______________________________________________________________________________________
Inicie uma conexão (RC/Meeting) com um id especificado no arquivo de controle fornecido (*.tvc)
Onde encontrar arquivos .tvc:
Exemplo: TeamViewer.exe --control C:\Users\shvarts\Desktop\A\abc.tvc
_______________________________________________________________________________________
Proxy IP e porta, formatados como: IPAddress:Port
Exemplo: TeamViewer.exe --ProxyIP 192.168.0.2:8080
_______________________________________________________________________________________
Usado em combinação com 'ProxyIP'. Nome de usuário proxy
Exemplo: TeamViewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin
_______________________________________________________________________________________
Usado em combinação com 'ProxyIP'. Senha Proxy Base64 codificada.
Exemplo: TeamViewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin --ProxyPassword test
_______________________________________________________________________________________
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
_______________________________________________________________________________________
teamviewer.exe -i <ID> -P <Password>
teamviewer.exe -i <ID> -P <Password> -m fileTransfer
teamviewer.exe -i <ID> -P <Password> -m vpn
No Windows, a tarefa de atribuição é iniciada assim:
TeamViewer.exe assign <options>
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.
Encontre cada opção e sua descrição abaixo.
As seguintes opções são suportadas:
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 para o novo dispositivo na lista de computadores e contatos. Se o dispositivo já estiver na lista de contatos, nenhum alias será aplicado
_______________________________________________________________________________________
DEFAULT VALUE: false
Concede acesso fácil após a atribuição (igual à opção "Grant easy access" na janela principal do TeamViewer)
_______________________________________________________________________________________
DEFAULT VALUE: false
Atribui o dispositivo à conta mesmo que o dispositivo já esteja atribuído a uma conta.
_______________________________________________________________________________________
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.
_______________________________________________________________________________________
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.
_______________________________________________________________________________________
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
_______________________________________________________________________________________
URL do seu proxy no formato <nome>:<porta>,
Exemplo: --proxy yourproxy:3201
_______________________________________________________________________________________
O nome de usuário usado para autenticação no proxy
_______________________________________________________________________________________
Senha usada para autenticação no proxy
_______________________________________________________________________________________
O mesmo que, --proxy-pw
mas a senha precisa ser inserida como uma string codificada em Base64.
_______________________________________________________________________________________
Necessário apenas para macOS. Ele pode ser usado para permitir um registro mais detalhado. Usado apenas em casos de análise de erros.
_______________________________________________________________________________________
A atribuição é repetida em caso de erros temporários. Observe que há um tempo de espera de 1 segundo entre cada tentativa.
_______________________________________________________________________________________
Defina o tempo limite geral em segundos usado para todas as tentativas de atribuição.
_______________________________________________________________________________________
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
📌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
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
No Windows, a COM API pode ser usada assim:
TeamViewer .exe api <options>
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
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:
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
Use os seguintes comandos do Powershell:
$tv = new-object -com TeamViewer.Application
Verifique se um erro será impresso no Powershell