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.