Como asignar un dispositivo a través de una línea de comandos

Opciones posibles en la línea de comandos:

Hay opciones adicionales que puedes añadir a tu línea de comandos:

Alias

Para Windows:

--device-alias=[<name>]

Alias ​​del nuevo dispositivo tal y como aparecerá en la lista de dispositivos; esta propiedad puede tomar los siguientes valores:

  1. --alias (sin valor)
    • alias del dispositivo será la ID de TeamViewer
  2. --alias hello
    • alias del dispositivo será "hello"
  3. Parámetro Alias no especificado 
    • alias de este dispositivo será %computername%
  4. --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

-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.

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
(49 under Linux/Free BSD)

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:

  1. Abre la Terminal.
  2. Introduce el siguiente comando (indicado a continuación) en la línea de comandos.
  3. 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:

  1. --alias (sin valor)
    • El alias del dispositivo será el ID de TeamViewer
  2. --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:

  1. --alias (sin valor)
    • El alias del dispositivo será el ID de TeamViewer
  2. --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.