Parámetros de línea de comandos

No hay clasificaciones

Este artículo va dirigido a los usuarios de TeamViewer con Windows y macOS.
Algunos parámetros solo están disponibles en la versión 13.2 de TeamViewer.

Parámetros de línea de comandos en Windows

Cómo usarlos

Parámetros con y sin valor

Existen dos tipos de parámetros: con valor y sin valor.
Ejemplo de parámetro sin valor: 

TeamViewer.exe --noInstallation

Ejemplo de parámetro con valor: 

TeamViewer.exe --id 123456789

En la mayoría de los casos se espera un solo valor. Si se indican múltiples valores, solo se utilizará el primero.
Si el valor de un parámetro contiene un espacio, este debe expresarse entre comillas.

Información diversa

Un parámetro largo se invoca de este modo (con dos «-» -> «--»): TeamViewer.exe --Minimize
Si tienes una variante corta, también puede invocarse con un solo «-» TeamViewer.exe -n

En algunas plataformas también es posible utilizar «--n». Pueden combinarse múltiples parámetros en una misma llamada. Los parámetros son sensibles a mayúsculas y minúsculas.

Tareas de línea de comandos

Normalmente, cuando los parámetros de línea de comandos son aceptados, TeamViewer seguirá ejecutándose. Sin embargo, existen algunas «tareas» que pueden dispararse a través de la línea de comandos tras las cuales TeamViewer se cerrará.

Tareas:

  • Asignación de dispositivos
  • instalación de la API de COM

Aplicación

Opciones compatibles:

 
Parámetro Variante corta Descripción
Minimize  

Iniciar TV minimizado.

Si la opción «iniciar TV con Windows» está activada, TV se iniciará en el área de notificación.

id  i

Inicia una conexión con el ID de asociado indicado.

Password P

Utilizado en combinación con «id». Contraseña utilizada para la conexión.

PasswordB64 B

Utilizado en combinación con «id». Contraseña encriptada en Base64 utilizada para la conexión.

mode m

Utilizado en combinación con «id». Modo de conexión utilizado para la conexión.

Si se omite, se utiliza el control remoto.

Valores soportados:

  • fileTransfer
  • vpn

Ejemplo: --mode fileTransfer

quality q

Utilizado en combinación con «id». Calidad de conexión utilizada para la conexión.

Valores soportados:

1: seleccionar calidad automática
2: optimizar calidad
3: optimizar velocidad
4: ajustes personalizados
5: indefinida

Ejemplo: --quality 2

ac a

Utilizado en combinación con «id». Permisos de control de acceso utilizados en la conexión saliente.

 Valores soportados:

0: acceso total
1: confirmar todo
2: ver y mostrar
3: personalizado
9: indefinido

Ejemplo: --ac 1

play  

Reproducir un archivo de sesión de TeamViewer (*.tvs)

Ejemplo: Teamviewer.exe  --play C:\Users\shvarts\Desktop\A\abc.tvs

control  

Iniciar una conexión (CR/reunión) a un ID indicado en el archivo de control (*.tvc).

Ubicación de los archivos *.tvc:
%appdata%\TeamViewer\MRU\RemoteSupport
%appdata%\TeamViewer\MRU\Meeting

Ejemplo: Teamviewer.exe  --control C:\Users\shvarts\Desktop\A\abc.tvc

ProxyIP  

IP de proxy y puerto, en el siguiente formato: direcciónIP:Puerto

Ejemplo: Teamviewer.exe --ProxyIP 192.168.0.2:8080

ProxyUser  

Utilizado en combinación con «ProxyIP».
Nombre de usuario del proxy

Ejemplo: Teamviewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin

ProxyPassword  

Utilizado en combinación con «ProxyIP». Contraseña del proxy encriptada en Base64

Ejemplo: Teamviewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin --ProxyPassword test

sendto  

Enviar una lista de archivos a un asociado de su lista de asociados.

Es posible que se abran cuadros de diálogo para iniciar sesión y seleccionar el destinatario.

Ejemplo:
Un único archivo: Teamviewer.exe --sendto C:\Users\shvarts\Desktop\A\abc.jpg
Varios archivos: Teamviewer.exe --sendto C:\Users\shvarts\Desktop\A\abc.jpg C:\Users\shvarts\Desktop\A\abcd.jpg

 

Asignación de dispositivos

En Windows, la tarea de asignación se inicia del siguiente modo:

TeamViewer.exe assign <options>

 En macOS se inicia del siguiente modo:

Versión Host: 

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment <options>

 Versión completa:

sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment <options>

Se requiere «sudo» para obtener permisos de administrador, ya que TeamViewer_Service graba AssignmentData.json con derechos restringidos. La herramienta solo puede ejecutarse desde el paquete de la aplicación. De lo contrario, la herramienta no encontrará las estructuras requeridas.

Si el valor (por ejemplo, grupo) contiene un espacio, debe expresarse entre comillas, o bien encerrar los espacios con «\» en macOS.
Usa «--» delante de cada opción en Windows y «-» en macOS.

Opciones compatibles:

Opción Requerida Valor por defecto Descripción

api-token

 sí

 

Token necesario para acceder a la API, que puede generarse en la management console (concretamente, en «Configuración del perfil/Aplicaciones»). También pueden utilizarse tokens para despliegue fácil de módulos Host personalizados.

Alias

   

Alias del nuevo dispositivo en la lista de ordenadores y contactos. Si el dispositivo ya se encuentra en la lista de contactos, no se aplicará el alias.

grant-easy-access

 

falso

Concede acceso fácil tras la asignación (al igual que la opción «Conceder acceso fácil» en la ventana principal de TeamViewer)

reassign

 

falso

Asigna el dispositivo a la cuenta aunque ya esté asignado a otra.

wait

 

10

Tiempo de espera en segundos que esperará la asignación a que se cree el archivo de datos. Normalmente, el valor por defecto es suficiente.

group

*

 

Nombre del grupo al que se añadirá el dispositivo. Si el grupo no existe, se creará automáticamente. Si el dispositivo ya está en la lista de ordenadores y contactos en un grupo diferente, no se moverá.

*No se requiere si se utiliza un módulo Host personalizado, ya que ya existe un grupo definido por defecto en la configuración personalizada.

--group-id

   

Esta opción es una alternativa al parámetro --group en caso de que se conozca el ID del grupo. Puede resultar útil en entornos de clientes muy grandes, ya que acelera el proceso de asignación. Normalmente basta con usar --group.

proxy

   

URL de su proxy en el siguiente formato: <nombre>:<puerto>, por ejemplo: --proxy suproxy:3201

proxy-user

   

Nombre de usuario utilizado para la autenticación contra el proxy.

proxy-pw

   

Contraseña utilizada para la autenticación contra el proxy.

proxy-pw-base64

   

Igual que --proxy-pw, pero la contraseña debe introducirse en forma de cadena encriptada en Base64. Útil para contraseñas con caracteres especiales.

verbose

(solo en macOS) 

 

Puede utilizarse para permitir registros más detallados. Solo debe usarse en casos de análisis de error.

 

Ejemplos

Windows

Asignación básica:

TeamViewer.exe assign --api-token 12345678 --group SomeGroup

 Usar un alias y conceder acceso fácil:

TeamViewer.exe assign --api-token 12345678 --group Some Group --devicealias %COMPUTERNAME% --grant-easy-access

 Usar un proxy con autenticación:

TeamViewer.exe assign --api-token 12345678 --group SomeGroup --reassign --proxy testproxy:3201 --proxy-user someuser --proxy-pw passwd

 

macOS

Los ejemplos son para la versión Host. Para la versión completa, sustituye TeamViewerHost.app por TeamViewer.app

 Asignación básica:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment assign YES -api-token 12345678 -group SomeGroup

 Usar un alias y conceder acceso fácil:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment assign YES -api-token 12345678 -group "Some Group" -alias $USER -grant-easy-access 

 Usar un proxy con autenticación:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment assign YES -api-token 12345678 -group SomeGroup -reassign -proxy testproxy:3201 -proxy-user someuser -proxy-pw passwd

 API de COM

En Windows, la API de COM puede utilizarse de la siguiente manera:

TeamViewer.exe api <options>

Opción Descripción versión de TeamViewer

--install

 Instalar la API de COM

>=3

--uninstall

 Desinstalar la API de COM

>=3

 

Comprobar que la instalación ha tenido éxito

Mediante archivo de registro

Abre el archivo de registro de TV desde %appdata%\TeamViewer y busca las siguientes 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

Mediante Windows Powershell

Utiliza los siguientes comandos de Powershell:

$tv = new-object -com TeamViewer.Application $tv.ApiVersion

Comprueba que cualquier versión se escribirá en Windows Powershell, por ejemplo:

Powershell1.png

Comprobar que la desinstalación ha sido exitosa

Mediante archivo de registro

Abre el archivo de registro de TV desde %appdata%\TeamViewer y busca las siguientes 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

Mediante Windows Powershell

Utiliza los siguientes comandos de Powershell:

$tv = new-object -com TeamViewer.Application

Comprueba que Powershell devolverá un error

Powershell2.png

 

Historial de versiones
Revisión n.º
3 de 3
Última actualización:
‎01 jul 2019, 3:42 PM
Actualizado por:
 
Colaboradores