Base de Conocimientos
Asigna instalaciones existentes de TeamViewer mediante una línea de comandos
Última modificación: 25 sept 2025
Puedes enviar TeamViewer a tus dispositivos a través de la línea de comandos. A continuación te indicamos cómo proceder en función del sistema operativo de tus dispositivos.
Como asignar un dispositivo a través de una línea de comandos
Para asignar un dispositivo Windows mediante una línea de comando, sigue las instrucciones a continuación:
- Abre el CMD
- Navega hasta la carpeta de instalación de TeamViewer.
- Introduce el siguiente comando (indicado a continuación) en la línea de comandos.
- Pulsa Enter en tu teclado.
- (opcional) Escribe
echo %errorlevel%
Para verificar si que en la línea de comandos el proceso se ha realizado correctamente:
- Si la asignación tuvo éxito, el valor "0" debe ser devuelto a la línea de comandos.
- Cualquier otro valor de retorno indica un problema ocurrido durante la asignación. Para más información, consulta la sección Codigos de error.
TeamViewer.exe assignment --id paste_your_assignment_id_here --offline
Ejemplo:
TeamViewer.exe assignment --id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
Opciones posibles en la línea de comandos:
Hay opciones adicionales que puedes añadir a tu línea de comandos:
Alias
--device-alias=[<name>]
El alias para el nuevo dispositivo tal y como aparecerá en la lista de dispositivos; esta propiedad puede tomar los siguientes valores:
- --alias (sin valor)
- alias del dispositivo será la ID de TeamViewer
- --alias hello
- alias del dispositivo será "hello"
- Parámetro Alias no especificado
- alias de este dispositivo será %computername%
- --alias %systemvariable%
- alias será la variable de sistema utilizada, p. ej.%username%
Ejemplo:
"C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=%COMPUTERNAME%-%USERNAME%
Sugerencia: Si quieres usar espacios, tienes que poner todo en "..." como en el siguiente ejemplo:
"C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=“%COMPUTERNAME% Test %USERNAME%“
Reintentar (Retries)
--retries
La asignación se vuelve a intentar en caso de errores temporales. Ten en cuenta que hay un tiempo de espera de 1 segundo entre cada intento.
Tiempo de espera (Timeout)
--timeout
Establece el tiempo de espera global en segundos utilizado para todos los intentos de asignación.
Ejemplo:
TeamViewer.exe assignment --id YOUR_ASSIGNMENT_ID
--retries=3 --timeout=120
Para dispositivos desconectados (offline devices)
--offline
Para gestionar los dispositivos que están desconectados durante el proceso de asignación, se guarda la asignación como una propiedad cifrada en el registro. Esta se ejecuta automáticamente cuando el dispositivo vuelve a conectarse y se elimina una vez que la asignación se completa con éxito.
Para reasignación con el mismo ID de asignación
--reassign
Este parámetro permite reasignar un dispositivo con el mismo ID de asignación. De forma predeterminada, los dispositivos rechazan los intentos de reasignación si el ID de asignación no ha cambiado. Usar --reassign aplica el ID de asignación existente en el dispositivo, lo cual puede ser útil cuando es necesario reasignarla sin generar un nuevo ID de asignación.
Códigos de error
| Códigos de error | Descripción | Problema/solución |
|---|---|---|
1 | Argumentos de línea de comandos no válidos | Parece que has escrito mal o has utilizado un comando incorrecto. Revisa el comando e inténtalo de nuevo. |
2 | Error de verificación de firma | - |
3 | Producto no instalado | TeamViewer no está instalado. Instala TeamViewer antes de realizar cualquier tarea o asignación. |
4 | Configuración del servicio: acceso fallido | // ComAPI No se pudo verificar la configuración de la asignación en TeamViewer Cloud. Inténtalo nuevamente más tarde. |
400 (40 under Linux/FreeBSD) | MDv2Assignment - Argumento invalido | Parece que hay un error en la sintaxis de la línea de comandos o se utiliza un ID de asignación no válido. Verifica la sintaxis general de la línea de comandos y verifica que el ID de asignación copiado sea una configuración válida desde la Management Console. |
401 (41 under Linux/FreeBSD) | MDv2Assignment - El servicio no se está ejecutando | No se puede realizar la tarea o asignación porque TeamViewer no se está ejecutando correctamente. Verifica que el servicio TeamViewer se esté ejecutando. |
402 (42 under Linux/FreeBSD) | MDv2Assignment - Versión incompatible del servicio | El servicio TeamViewer no es compatible con la versión del client TeamViewer ejecutada. Parece que la instalación no se ha completado correctamente. Comprueba la instalación y, si es necesario, vuelve a instalar TeamViewer. |
403 (43 under Linux/FreeBSD) | MDv2Assignment - Fuera de linea | El client de TeamViewer no pudo conectarse a la nube de TeamViewer para asignar tu dispositivo. Verifica si el client está en línea y si tu conexión a Internet funciona correctamente y vuelve a intentar la asignación. Considera usar la opción de reintentos en la interfaz de línea de comandos si esto sucede con frecuencia. |
404 (44 under Linux/FreeBSD) | MDv2Assignment - en ejecución | Ya se está ejecutando otro proceso de asignación. Verifica el estado de esa asignación. Puedes hacerlo, por ejemplo, verificando si el dispositivo ya está registrado como dispositivo gestionado en la Management Console. |
405 (45 under Linux/FreeBSD) | MDv2Assignment - Tiempo de espera | Se agotó el tiempo de espera de tu tarea o asignación. Inténtalo nuevamente. Considera aumentar el tiempo de espera en la interfaz de línea de comandos en caso de que esto suceda con frecuencia o la red sea inestable, por ejemplo, en el caso de dispositivos móviles. |
406 (46 under Linux/FreeBSD) | MDv2Assignment - fallido | Tu tarea o asignación falló debido a razones desconocidas. Guarda tus registros y ponte en contacto con el servicio de asistencia. |
407 (47 under Linux/FreeBSD) | MDv2Assignment - acceso denegado | No tienes el permiso necesario para ejecutar una tarea o asignación. Asegúrate de que tu usuario tenga derechos de administrador local. |
408 (48 under Linux/FreeBSD) | MDv2Assignment - Denegado por política | La política de TeamViewer activa en este dispositivo impide eliminar el estado de asignación existente. Desactiva la política en la Management Console.
Nota: La reasignación elimina implícitamente el estado existente y, por lo tanto, también se deniega. |
409 | MDv2Assignment - Dispositivo ya gestionado | El dispositivo ya está asignado a tu empresa con el mismo ID de asignación. |
Requisitos previos:
- TeamViewer ya está instalado.
- Para el full client de TeamViewer, la opción "Iniciar con macOS" debe estar activada.
Para asignar un dispositivo macOS mediante la línea de comandos, sigue las instrucciones a continuación:
- Abre la Terminal.
- Introduce el siguiente comando (indicado a continuación) en la línea de comandos.
- haz clic en Intro (Enter)
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -assignment_id <ID> --offline
Ejemplo:
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
Ejemplo:
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -assignment_id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
Opción de línea de comandos opcional
Esta es una opción adicional que puedes agregar a tu línea de comando:
Alias
-device_alias [<name>]
Alias para el nuevo dispositivo en la lista de dispositivos. No se aplicará ningún alias si el dispositivo ya está en la lista de contactos. La propiedad puede tener los siguientes valores:
- --alias (sin valor)
- El alias del dispositivo será el ID de TeamViewer
- --alias hello
- El alias del dispositivo será "hello"
--offline
Para gestionar los dispositivos que están desconectados durante la asignación, almacena la asignación en el registro como una propiedad cifrada. Esta se ejecutará automáticamente cuando el dispositivo se conecta. Esta propiedad se elimina una vez que el dispositivo se asigna correctamente.
sudo teamviewer assignment --id paste_your_assignment_id_here --offline
Ejemplo:
sudo teamviewer assignment --id 0001CoABChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAO4PLaOBrqNDgr6jwtNCVK_JiM5lVdgdfgYo3uQ3pGkAbX8bo_VqPw1Rt61-RLe9AKSwZ14uwOXtUN7FYflrHbWAqRKBF0h8V18ldMcVT1rLF --offline
Opción de línea de comandos opcional
Alias
--device_alias [<name>]
Alias para el nuevo dispositivo en la lista de dispositivos. No se aplicará ningún alias si el dispositivo ya está en la lista de contactos. La propiedad puede tener los siguientes valores:
- --alias (sin valor)
- El alias del dispositivo será el ID de TeamViewer
- --alias hello
- El alias del dispositivo será "hello"
--offline
Para gestionar los dispositivos que están desconectados durante la asignación, almacena la asignación en el registro como una propiedad cifrada. Esta se ejecutará automáticamente cuando el dispositivo se conecta. Esta propiedad se elimina una vez que el dispositivo se asigna correctamente.
Códigos de error
| Error code | Description | Problem/solution |
|---|---|---|
400 (40 under Linux/FreeBSD) | MDv2Assignment - Argumento invalido | Parece haber un error en la sintaxis de la línea de comandos o se ha utilizado un ID de asignación no válido. Revisa la sintaxis general de la línea de comandos y verifica que el ID de asignación copiado sea una configuración válida desde la Consola de administración. |
401 (41 under Linux/FreeBSD) | MDv2Assignment - El servicio no se está ejecutando | No se puede realizar la tarea o asignación porque TeamViewer no se está ejecutando correctamente. Verifica que el servicio TeamViewer se esté ejecutando. |
402 (42 under Linux/FreeBSD) | MDv2Assignment - Versión incompatible del servicio | El servicio TeamViewer no es compatible con la versión del client TeamViewer ejecutada. Parece que la instalación no se ha completado correctamente. Comprueba la instalación y, si es necesario, vuelve a instalar TeamViewer. |
403 (43 under Linux/FreeBSD) | MDv2Assignment - Fuera de linea | El client de TeamViewer no pudo conectarse a la nube de TeamViewer para asignar tu dispositivo. Verifica si el client está en línea y si tu conexión a Internet funciona correctamente y vuelve a intentar la asignación. Considera usar la opción de reintentos en la interfaz de línea de comandos si esto sucede con frecuencia. |
404 (44 under Linux/FreeBSD) | MDv2Assignment - en ejecución | Ya se está ejecutando otro proceso de asignación. Verifica el estado de esa asignación. Puedes hacerlo, por ejemplo, verificando si el dispositivo ya está registrado como dispositivo gestionado en la Management Console. |
405 (45 under Linux/FreeBSD) | MDv2Assignment - Tiempo de espera | Se agotó el tiempo de espera de tu tarea o asignación. Inténtalo nuevamente. Considera aumentar el tiempo de espera en la interfaz de línea de comandos en caso de que esto suceda con frecuencia o la red sea inestable, por ejemplo, en el caso de dispositivos móviles. |
406 (46 under Linux/FreeBSD) | MDv2Assignment - fallido | Tu tarea o asignación falló debido a razones desconocidas. Guarda tus registros y ponte en contacto con el servicio de asistencia. |
407 (47 under Linux/FreeBSD) | MDv2Assignment - acceso denegado | No tienes los permisos necesarios para ejecutar una tarea. Asegúrate de que tu usuario tenga permisos de administrador local. |
408 (48 under Linux/FreeBSD) | MDv2Assignment - Denegado por política | La política de TeamViewer activa en este dispositivo impide eliminar el estado de asignación existente. Desactiva la política en la Management Console.
Nota: La reasignación elimina implícitamente el estado existente y, por lo tanto, también se deniega. |
Como actualizar/sobre escribir una tarea
Si ya tienes un dispositivo asignado y vuelves a ejecutar la asignación a través de la línea de comandos, la asignación del dispositivo se sobrescribe con la antigua. La sobrescritura implica que la asignación antigua se elimina, y los gestores o políticas ya asignados se perderán.
Nota: La política de TeamViewer "impide la eliminación de la asignación" también impide una nueva asignación en un dispositivo ya asignado.