Base de Conhecimento
Atribua instalações existentes do TeamViewer via linha de comando
Last Modified: 29 de set. de 2025
Como atribuir um dispositivo via linha de comando
Para atribuir um dispositivo Windows via linha de comando, siga as instruções abaixo:
- Abra o CMD.
- Navegue até a pasta de instalação do TeamViewer.
- Digite o seguinte comando (indicado abaixo) na linha de comando.
- Pressione Enter no seu teclado.
- (opcional) Tipo
eco %níveldeerro%
Na linha de comando para verificar se o processo foi bem-sucedido:
- Se a atribuição for bem-sucedida, o valor "0" deverá ser retornado para a linha de comando.
- Qualquer outro valor de retorno indica um problema que ocorreu durante a atribuição. Para mais informações, consulte a seção Códigos de erro.
TeamViewer.exe assignment --id paste_your_assignment_id_here --offline
Exemplo:
TeamViewer.exe assignment --id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
Opções opcionais de linha de comando
Existem opções adicionais que você pode adicionar à sua linha de comando:
Pseudônimo
--device-alias=[<name>]
O pseudônimo do novo dispositivo aparecerá na lista de dispositivos. Essa propriedade pode assumir os seguintes valores:
--alias (sem valor)- pseudônimo do computador será o TeamViewer ID
- --alias hello
- pseudônimo do computador será "hello"
- Parâmetro de pseudônimo não especificado
- pseudônimo deste computador será %computername%
- --alias %systemvariable%
- pseudônimo será a variável de sistema usada, por exemplo %username%
Exemplo:
C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=%COMPUTERNAME-%USERNAME%
Dica: Se quiser usar espaços, tem que colocar tudo em "..." como no exemplo a seguir:
C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=“%COMPUTERNAME Test %USERNAME%“
Tentativas
--retries
A atribuição é repetida em caso de erros temporários. Observe que há um tempo de espera de 1 segundo entre cada tentativa.
Tempo de espera
--timeout
Defina o tempo limite geral em segundos usado para todas as tentativas de atribuição.
Exemplo:
TeamViewer.exe assignment --id YOUR_ASSIGNMENT_ID --retries=3 --timeout=120
Para dispositivos offline
--offline
Para lidar com dispositivos que estão offline durante a atribuição, ele armazena a atribuição no registro como uma propriedade criptografada e a executa automaticamente quando o dispositivo fica online. Essa propriedade é excluída assim que o dispositivo é atribuído com sucesso.
Para reatribuição com o mesmo ID de atribuição
--reassign
Esse parâmetro permite que você reatribua um dispositivo usando o mesmo ID de atribuição. Por padrão, os dispositivos rejeitam tentativas de reatribuição se a ID de atribuição não tiver sido alterada. O uso de --reassign impõe a ID de atribuição existente no dispositivo, o que pode ser útil em cenários em que a atribuição precisa ser reaplicada sem gerar uma nova ID de atribuição.
Códigos de erro
| Código de erro | Descrição | Solução do problema | |||
|---|---|---|---|---|---|
1 |
|
| |||
2 |
| - | |||
3 |
|
| |||
4 |
|
| |||
|
|
| |||
401 (41 sob Linux/FreeBSD) | Atribuição MDv2 - serviço não está em execução | A atribuição não pode ser realizada porque o TeamViewer não está sendo executado corretamente. Verifique se o serviço TeamViewer está em execução. | |||
402 (42 sob Linux/FreeBSD) | Atribuição MDv2 - versão incompatível do serviço | O serviço TeamViewer é incompatível com a versão do cliente TeamViewer executado. Parece que a instalação não foi concluída corretamente. Verifique a instalação e, se necessário, reinstale o TeamViewer novamente. | |||
403 (43 sob Linux/FreeBSD) | Atribuição MDv2 - não está online | O cliente TeamViewer não pôde se conectar à nuvem TeamViewer para atribuir seu dispositivo. Verifique se o cliente está on-line e se sua conexão com a Internet está funcionando corretamente e repita a tarefa. Considere usar a opção de novas tentativas na interface de linha de comando se isso acontecer com frequência. | |||
404 (44 sob Linux/FreeBSD) | Atribuição MDv2 - já em execução | Outro processo de atribuição já está em execução. Verifique o status dessa atribuição. Você pode fazer isso, por exemplo, verificando se o dispositivo já está registrado como um dispositivo gerenciado no console de gerenciamento. | |||
405 (45 sob Linux/FreeBSD) | Atribuição MDv2 - tempo limite | Sua tentativa de atribuição expirou. Por favor, tente novamente. Considere aumentar o tempo limite na interface da linha de comando caso isso aconteça com frequência e/ou a rede esteja instável, por exemplo. dispositivos móveis. | |||
406 (46 sob Linux/FreeBSD) | Atribuição MDv2 - falhou | Sua atribuição falhou devido a motivos desconhecidos. Salve seus logs e entre em contato com o suporte. | |||
407 (47 sob Linux/FreeBSD) | Atribuição MDv2 - acesso negado | Você não tem a permissão necessária para executar uma atribuição. Certifique-se de que seu usuário tenha direitos de administrador local. | |||
408 (48 sob Linux/FreeBSD) | Atribuição MDv2 - Negada pela política | A política do TeamViewer ativa neste dispositivo impede a remoção do estado de atribuição existente. Desative a política no Console de Gerenciamento. Observação: A reatribuição remove implicitamente o estado existente e, portanto, também é negada. | |||
409 | MDv2Assignment - Dispositivo já gerenciado | O dispositivo já está atribuído à sua empresa com o mesmo ID de atribuição. |
Pré-requisitos:
- O TeamViewer já está instalado.
- Para o TeamViewer full client, a opção Iniciar com macOS precisa estar habilitada.
Para atribuir um dispositivo macOS via linha de comando, siga as instruções abaixo:
- Abra o Terminal.
- Digite o seguinte comando (indicado abaixo) na linha de comando.
- Pressione Enter no seu teclado.
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -assignment_id <ID> --offline
Exemplo:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -assignment_id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -assignment_id paste_your_assignment_id_here --offline
Exemplo:
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -assignment_id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
Opção de linha de comando opcional
Esta é uma opção adicional que você pode adicionar à sua linha de comando:
Pseudônimo
-device_alias [<name>]
Alias para o novo dispositivo na lista de dispositivos. Nenhum alias será aplicado se o dispositivo já estiver na lista de contatos. A propriedade pode assumir os seguintes valores:
- --alias (sem valor)
- o pseudônimo do computador será o ID do TeamViewer
- --alias olá
- o pseudônimo do computador será "olá"
Para dispositivos offline
--offline
Para lidar com dispositivos que estão offline durante a atribuição, ele armazena a atribuição no registro como uma propriedade criptografada e a executa automaticamente quando o dispositivo fica online. Essa propriedade é excluída assim que o dispositivo é atribuído com sucesso.
Para reatribuição com o mesmo ID de atribuição
--reassign
Esse parâmetro permite que você reatribua um dispositivo usando o mesmo ID de atribuição. Por padrão, os dispositivos rejeitam tentativas de reatribuição se a ID de atribuição não tiver sido alterada. O uso de --reassign impõe a ID de atribuição existente no dispositivo, o que pode ser útil em cenários em que a atribuição precisa ser reaplicada sem gerar uma nova ID de atribuição.
sudo teamviewer assignment --id paste_your_assignment_id_here --offline
Exemplo:
sudo teamviewer assignment --id 0001CoABChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAO4PLaOBrqNDgr6jwtNCVK_JiM5lVdgdfgYo3uQ3pGkAbX8bo_VqPw1Rt61-RLe9AKSwZ14uwOXtUN7FYflrHbWAqRKBF0h8V18ldMcVT1rLF --offline
Opção de linha de comando opcional
Esta é uma opção adicional que você pode adicionar à sua linha de comando:
Pseudônimo
--device_alias [<name>]
Alias para o novo dispositivo na lista de dispositivos. Nenhum alias será aplicado se o dispositivo já estiver na lista de contatos. A propriedade pode assumir os seguintes valores:
- --alias (sem valor)
- o pseudônimo do computador será o ID do TeamViewer
- --alias olá
- o pseudônimo do computador será "olá"
Para dispositivos offline
--offline
Para lidar com dispositivos que estão offline durante a atribuição, ele armazena a atribuição no registro como uma propriedade criptografada e a executa automaticamente quando o dispositivo fica online. Essa propriedade é excluída assim que o dispositivo é atribuído com sucesso.
Para reatribuição com o mesmo ID de atribuição
--reassign
Esse parâmetro permite que você reatribua um dispositivo usando o mesmo ID de atribuição. Por padrão, os dispositivos rejeitam tentativas de reatribuição se a ID de atribuição não tiver sido alterada. O uso de --reassign impõe a ID de atribuição existente no dispositivo, o que pode ser útil em cenários em que a atribuição precisa ser reaplicada sem gerar uma nova ID de atribuição.
Códigos de erro
| Error code | Description | Problem/solution |
|---|---|---|
406 (46 no Linux/FreeBSD) | MDv2Assignment - falhou | Sua tarefa falhou por motivos desconhecidos. Salve seus registros e entre em contato com o suporte. |
407 (47 no Linux/FreeBSD) | MDv2Assignment - acesso negado | Você não tem a permissão necessária para executar uma tarefa. Certifique-se de que seu usuário tenha direitos de administrador local. |
408 (48 no Linux/FreeBSD) | MDv2Assignment - Negado pela política | A política do TeamViewer ativa neste dispositivo impede a remoção do estado de atribuição existente. Desative a política no Management Console. |
400 (40 no Linux/FreeBSD) | MDv2Assignment - argumento inválido | Parece haver um erro na sintaxe da linha de comando ou um ID de atribuição inválido está sendo usado. Verifique a sintaxe geral da linha de comando e se o ID de atribuição copiado corresponde a uma configuração válida do Management Console. |
401 (41 no Linux/FreeBSD) | MDv2Assignment - serviço não está em execução | A tarefa não pode ser realizada porque o TeamViewer não está funcionando corretamente. Verifique se o serviço TeamViewer está em execução. |
402 (42 no Linux/FreeBSD) | MDv2Assignment - versão incompatível com o serviço | O serviço TeamViewer é incompatível com a versão do TeamViewer executada. Parece que a instalação não foi concluída corretamente. Verifique a instalação e, se necessário, reinstale o TeamViewer. |
403 (43 no Linux/FreeBSD) | MDv2Assignment - não está online | O TeamViewer não conseguiu se conectar à nuvem do TeamViewer para atribuir seu dispositivo. Verifique se o cliente está online e se sua conexão com a internet funciona corretamente e tente a atribuição novamente. Considere usar a opção de novas tentativas na interface de linha de comando se isso acontecer com frequência. |
404 (44 no Linux/FreeBSD) | MDv2Assignment - já em execução | Outro processo de atribuição já está em andamento. Verifique o status dessa atribuição. Você pode fazer isso, por exemplo, verificando se o dispositivo já está registrado como um dispositivo gerenciado no Management Console. |
405 (45 no Linux/FreeBSD) | MDv2Assignment - tempo expirou | Sua tentativa de atribuição expirou. Tente novamente. Considere aumentar o tempo limite na interface de linha de comando caso isso aconteça com frequência e/ou a rede esteja instável, como redes móveis. |
Como atualizar/substituir uma tarefa
Se você já tem um dispositivo designado e executa a designação através da linha de comando novamente, a designação do dispositivo é sobrescrito pelo antigo. A sobrescrita implica que a atribuição antiga é excluída, e os gerentes ou políticas já atribuídas serão perdidas.
Observação: A política do TeamViewer Evitar a remoção da atribuição da conta também impede uma nova atribuição em um dispositivo já atribuído.