Mejoras en la implementación masiva

No hay clasificaciones

Leer el artículo en inglés


Este artículo se dirige a todos los clientes de TeamViewer con una licencia corporativa o de tensor.

Este artículo se aplica a la versión 13.2 o más reciente de TeamViewer.

Versiones de Windows compatibles: Win 7, Win 8 and Win 10

Este artículo explica cómo puedes implementar TeamViewer Host y TeamViewer Full en un escenario de implementación masiva en Windows.

Instalación

Para Windows, TeamViewer ofrece 2 instaladores MSI:

  1. TeamViewer_Host.msi: este instalará el módulo de Host (personalizado) de TeamViewer
  2. TeamViewer_Full.msi: este instalará la versión completa de TeamViewer

Client de Host estándar 

Para instalar TeamViewer en un escenario de despliegue masivo sin interacción del usuario, sólo tienes que utilizar el siguiente comando desde tu script, directamente desde la línea de comandos o en tu solución de despliegue:

  1. msiexec.exe /i "<path to your TeamViewer_Host.msi>" /qn

    La propiedad /i indica que deseas realizar una instalación
    La propiedad /qn obliga a que la instalación sea silenciosa. Esto significa que no se requiere la interacción del usuario durante la instalación.
    msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn

 La instalación de TeamViewer requiere derechos de administrador. Hay más propiedades para el instalador de Windows disponibles para controlar la instalación. Simplemente escribe en la línea de comandos: msiexec.exe /?

Cliente de Host personalizado

Cuando desees instalar un Host personalizado sin interacción del usuario, deberás seguir estos pasos:

  1. Crear una nueva personalización o abrir una existente

    Cómo personalizar tu Host: Visita la página de diseñar y distribuir  para configurar la Management Console de TeamViewer. Después de crear tu Host personalizado, se creará una ID de configuración. Puedes encontrarla haciendo clic en editar en la entrada del módulo correspondiente en la parte inferior de la página abierta.1_Customized_Host_Editing.png

  2. Copia la ID de configuración desde tu Host personalizado.
  3. Abre la línea de comandos de Windows (CMD) con derechos de administrador o ejecuta MSI a través de un script (batch, etc.).

    La línea de comandos deben iniciarse como administrador. Si ejecutas MSI dentro de un script, el script también debe ejecutarse con derechos de administrador.

  4. Escribe en la línea de comandos: msiexec.exe /i "Path\To\TeamViewer_Host.msi>" /qn CUSTOMCONFIGID=<YOUR_CUSTOMCONFIG_ID> 
    msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn CUSTOMCONFIGID=<YOUR_CUSTOMCONFIG_ID>
  5. A continuación, se muestra un ejemplo de lo que se necesita para asignar el dispositivo con las personalizaciones.
    msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn CUSTOMCONFIGID=$CONFIGID APITOKEN=$YOURTOKEN ASSIGNMENTOPTIONS="--grant-easy-access"
 

Versión completa del Cliente

Para instalar TeamViewer en un escenario de despliegue masivo sin interacción del usuario, debes seguir estos pasos:

  1. Abre la línea de comandos de Windows (CMD) con derechos de administrador o ejecuta MSI a través de un script (batch, etc.).

    La línea de comandos debe iniciarse como administrador. Si ejecutas MSI dentro de un script, el script también debe ejecutarse con derechos de administrador.

  2. Escribe en la línea de comandos: msiexec.exe /i "Path\To\TeamViewer_Full.msi>" /qnThe property /i indaca que quieres haver una instalación
    La propiedad /qn obliga a que la instalación sea silenciosa. Esto significa que no se requiere la interacción del usuario durante la instalación.
    msiexec.exe /i "Path\To\TeamViewer_Full.msi" /qn

Ayuda para el instalador de Windows: Hay más propiedades disponibles para el instalador de Windows para controlar la instalación, simplemente escribe lo siguiente en la línea de comandos: msiexec.exe /?

 

Personaliza el cliente completo

Por favor, lee este artículo para saber cómo hacerlo. 

Configuración de la instalación

Aplica los ajustes de TeamViewer (recomendado)

  1. Exporta un archivo de configuración de un cliente de TeamViewer. Desde la versión 15.4, recibirás un archivo *.tvopt. En versiones anteriores TeamViewer exportaba un archivo *.reg. Para la importación, puedes utilizar ambos tipos de archivo, pero te recomendamos que utilices el archivo *.tvopt..

    Cómo obtener el archivo de configuración: Instala TeamViewer en un solo ordenador y configúralo según tus necesidades.
    En el diálogo de opciones (Extras | Opciones) en la categoría "Avanzado", haga clic en "Exportar..." para exportar el archivo de opciones.

  2. Añade la propiedad SETTINGSFILE="ABSOLUTE_PATH/TO/SETTINGSFILE" a tu comando al instalar TeamViewer_Host.msi o TeamViewer_Full.msi. La ruta dada debe ser una ruta local o una ruta a una red compartida.
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn SETTINGSFILE="C:/my_settingsfile.tvopt"
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn SETTINGSFILE="\\share\my_settingsfile.tvopt"

Aplica la configuración de TeamViewer (desaprobada)

El parámetro ARCHIVO DE IMPORTACIÓN está desactualizado desde la versión 15.4. Actualmente todavía se puede usar con la versión 15.3 o anterior, pero el código se eliminará en una próxima versión. Por lo tanto, te recomendamos cambiar al parámetro ARCHIVO DE AJUSTE.

    1. Coloca el archivo de configuración "TeamViewer_Settings.reg" (el nombre del archivo es obligatorio) en el mismo directorio que el archivo MSI.

Cómo obtener el archivo de configuración: Instala TeamViewer en un solo ordenador y configúralo según tus necesidades. En el diálogo de opciones (Extras | Opciones) en la categoría "Avanzado", haga clic en "Exportar..." para exportar el archivo de configuración.

                 

              2. Coloca el archivo de configuración "TeamViewer_Settings.reg" (el nombre del                        archivo es obligatorio) en el mismo directorio que el archivo MSI.

msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn IMPORTREGFILE=1

 

Asigna tu cliente anfitrión (Host) o completo (Full) a una cuenta

En el proceso de despliegue masivo, podría ser útil asignar la nueva instalación de TeamViewer a una cuenta existente. Puedes hacerlo de la siguiente manera:

  1. Agrega la propiedad ASSIGNMENTOPTIONS="<añade aquí tus opciones de asignación>" y APITOKEN=<Tu APITOKEN> al comando

 

msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=1309601-k9lhF9qo6MZIijO9P12D ASSIGNMENTOPTIONS="--group MyGroup"

 

 

Resumen de parámetros

Parámetro

¿Disponible para Host o para la versión completa de Client?

Descripción

CUSTOMCONFIGID

 Host

Versión completa de Client

La ID de configuración es necesaria para instalar un host personalizado y un client completo personalizado. La ID de configuración se puede recuperar de la Management Console.

DESKTOPSHORTCUTS

Host

Versión completa de Client

Controla si se creará un atajo en el escritorio para iniciar/mostrar TeamViewer.

0: No crear atajo
1: Crear atajo (por defecto)

ENABLEOUTLOOKPLUGIN

 Host

Versión completa de Client

Controla la desactivación/activación del plugin de Outlook
true: El plugin de TeamViewer para Outlook se activa después de la instalación (por defecto)
falso: El plugin de TeamViewer para Outlook está desactivado después de la instalación

Ejemplo:

 

msiexec.exe /i "Path\To\TeamViewer_Host.msi" ENABLEOUTLOOKPLUGIN="false"

 

APITOKEN

 Host

Versión completa de Cliente

 

API token generado en la Management Console de TeamViewer para la asignación de cuentas.

ASSIGNMENTOPTIONS

Host

Versión completa de Cliente

 Las opciones de asignación son necesarias para asignar el cliente de TeamViewer a una cuenta existente. Para obtener una lista de las opciones de asignación disponibles, consulta la sección "Opciones de asignación" al final de esta página

SETTINGSFILE

Host

Versión completa de Cliente

 

La propiedad SETTINGSFILE se utiliza para importar opciones para TeamViewer. El valor debe ser una ruta local absoluta válida o una ruta a una red compartida.

No utilices este parámetro en combinación con IMPORTREGFILE!

IMPORTREGFILE

Host

Versión completa de Cliente

 

El parámetro IMPORTREGFILE se utiliza para importar la configuración de TeamViewer: los ajustes se importan desde el archivo TeamViewer_Settings.reg.

0: no hay ajustes que importar

 

Actualización de TeamViewer

TeamViewer_Host.msi

Si deseas instalar el Client de Host de TeamViewer y ya tienes instalada una versión de TeamViewer, debes comprobar que la ruta de actualización específica sea compatible. La siguiente tabla explica cuándo es posible realizar una instalación y cuándo es necesario desinstalar la versión anterior.

Versión existente e instalación de TeamViewer

behavior when installing TeamViewer_Host.msi (TV 14.1)

Solución

Client completo (cualquier versión)

Instalación no será ejecutada

  1. desinstala versión completa
  2. ejecuta msi

Host client (misma versión que la instalada)

Instalación no será ejecutada

  1. desinstala el Client de Host
  2. ejecuta msi

Host client (versión 13.2 y superior)

Instalación satisfactoria

-

Cliente de Host (versión 13.1 o anterior)

Instalación no será ejecutada

  1. desinstala el Client de Host
  2. ejecuta msi

 

TeamViewer.msi

Si deseas instalar el cliente completo de TeamViewer y ya tienes una versión de TeamViewer instalada, debes tener en cuenta que el TeamViewer_Full.msi (TV 14.0 o superior) no es compatible con ninguna versión de TeamViewer instalada anteriormente:

Instalaciones y versiones existentes de TeamViewer

comportamiento al instalar TeamViewer_Host.msi (TV 14.1)

Solución

Cliente completo (cualquier versión)

Instalación no será ejecutada

  1. desinstala Cliente completo
  2. ejecuta msi

Cliente anfitrión (misma versión que la instalada)

Instalación no será ejecutada

  1. desinstala Cliente completo
  2. ejecuta msi

Cliente anfitrión (13.2 o anterior)

Instalación satisfactoria

-

Cliente anfitrión (versión 13.1 y anteriores)

Instalación no será ejecutada

  1. desinstala Client de Host completo
  2. ejecuta msi

 

La actualización automática en TeamViewer ya no está disponible si se utiliza el archivo MSI para la instalación. Se debe volver a actualizar con el Windows Installer.

Desinstalación de TeamViewer

Puedes desinstalar tu TeamViewer si es necesario (por ejemplo, si deseas cambiar de una versión de host a una versión completa):

  1. Usando exactamente el mismo instalador MSI de Windows que usaste para la instalación.
  2. Usando la funcionalidad del sistema operativo.

Desinstalación automática con el instalador de Windows

Puedes utilizar el comando de desinstalación del instalador de Windows (/uninstall o /x). Asegúrate de utilizar el msi correcto (versión completa o Host) para la desinstalación.

msiexec.exe /uninstall X:\TeamViewer_Host.msi

Son necesarios derechos de administrador para iniciar la línea de comandos.

Asignación

Introducción

Puedes configurar el módulo Host de TeamViewer de manera que al instalarse se añada automáticamente a una cuenta de TeamViewer. Lo puedes hacer durante la instalación.

Esta descripción es válida hasta TeamViewer 14.x así como para el Host v13.2.

Puedes hacer la asignación de un dispositivo a una cuenta de TeamViewer de dos maneras:

  1. Con el instalador MSI de Windows (TeamViewer_Full.msi or TeamViewer_Host.msi)
  2. Con el ejecutable de TeamViewer después de la instalación (TeamViewer.exe)

Si tienes una versión anterior de TeamViewer, tienes que hacer la asignación de la cuenta con la herramienta de asignación. Encontrarás más información aquí.

Cómo hacer la asignación

Para hacer la asignación, necesitas:

  1. (obligatorio) un API token válido
  2. (opcional) las opciones de asignación para definir mejor cómo debería de ser asignado el dispositivo.

    Un API token puede ser recuperado de dos maneras:
    1. De tu configuración de Host personalizado, si has activado la opción de permitir la asignación de cuenta a través de la herramienta de asinación al crearlo.
    2. Puedes crear un script de token en tu perfil de usuario > aplicaciones. Este script token necesita como mínimo los siguientes permisos:
         Gestión de grupo --> ver grupos
         Ordenadores & contactos --> ver, añadir, editar y eliminar entradas

Asignación con el instalador de Windows

Para realizar la asignación durante el proceso de instalación, sólo tienes que ejecutar tu instalación MSI y añadir la propiedad APITOKEN y opcionalemnte el parámetro ASSIGNMENTOPTIONS

  • Cliente anfitrión (Client host):
    msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> [ASSIGNMENTOPTIONS="<YOUR OPTIONAL SETTINGS>"]
  • Cliente completo (Full client):
    msiexec.exe /i "Path\To\TeamViewer_Full.msi" /qn APITOKEN=<YOUR_APITOKEN> [ASSIGNMENTOPTIONS="<YOUR OPTIONAL SETTINGS>"]
 

Asignación con el archivo ejecutable de TeamViewer

También es posible realizar la asignación una vez instalado el client de Host o la versión completa de TeamViewer. Para realizar la asignación, es importante que TeamViewer ya esté ejecutándose en el dispositivo.

Invoca el .exe de TeamViewer. o directamente TeamViewer con el comando assign seguido del parámetro --api-token y sus opciones de asignación:

TeamViewer.exe assign --api-token <APITOKEN> --group-id <GROUP_ID> --grant-easy-access --reassign --proxy <YOUR_PROXY> --proxy-user <YOUR_PROXY_USER> --proxy-pw <PASSWORD>


Opciones de asignación

Opción

Descripción

--alias [<name>]

Alias para el nuevo dispositivo en la lista de equipos y contactos. Si el dispositivo ya está en la lista de contactos, no se aplicará ningún alias. El parámetro puede tomar los siguientes valores:

  1. -alias (sin valor) → alias del ordenador será la ID de TeamViewer
    msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--alias --group MyGroup"
  2. -alias hallo → alias del ordenador será "hallo"
    msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--alias hello --group MyGroup"
  3. alias parámetro no especificado → alias de este ordenador será %computername%

    msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--group MyGroup"

--grant-easy-access

Si configuras esta opción se concederá el acceso sencillo después de la asignación (así como la opción "Conceder acceso fácil" en la ventana principal de TeamViewer).

msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--grant-easy-access --group MyGroup"

--reassign

Asigna el dispositivo a la cuenta incluso si el dispositivo ya está asignado a una cuenta.

msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--reassign --group MyGroup"

--group <name>

Nombre del grupo en el que se añadirá el dispositivo. Cuando el grupo no exista, se creará automáticamente. Si el dispositivo ya está presente en la lista de equipos y contactos en un grupo diferente, no se moverá al grupo. Sin embargo, si utilizas el parámetro "--reassign", también se moverá el grupo.

msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--group MyGroup"

No es necesario si se utiliza un Host personalizado, ya que existe un grupo predeterminado definido en la configuración personalizada.

--group-id <ID>

Esta opción es una alternativa para utilizar el parámetro --group si se conoce la ID del grupo. Esto puede ser útil en entornos de clientes muy grandes, ya que acelera el proceso de asignación. Por lo general, el uso de --group es suficiente.
Ten en cuenta que la ID debe ir precedida literalmente de una "g".

Puedes encontrar la identificación de grupo al iniciar sesión en la Management Console, haciendo clic en el grupo y comprobando la URL. Al final de la URL verás "g/12345678".

Por favor, retira el "/" para obtener tu identificación de grupo.

msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--group-id g123"

--proxy <name>:<port>

Url de tu proxy (sólo para la asignación) en el formato <name>:<port>, p.ej. --proxy yourproxy:3201

msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass --group MyGroup"

(warning) URL sin http://

--proxy-user <name>

Nombre de usuario que se utiliza para la autenticación contra el proxy (sólo para la asignación).

msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass --group MyGroup"

--proxy-pw <password>

Contraseña que se utiliza para la autenticación contra el proxy (sólo para la asignación).

msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass --group MyGroup"

--proxy-pw-base64 <encoded_password>

Igual que --proxy-pw, pero la contraseña debe ser introducida como una cadena codificada en Base64. Útil para contraseñas con caracteres especiales.

msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw-base64 bXlwYXNz --group MyGroup"

 

Ayuda para las opciones de asignación

  • Si tienes valores de parámetros con espacios en blanco (por ejemplo, para el nombre del grupo), utiliza dos comillas dobles (¡no comillas dobles simples!) para enmarcarlos.

    msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--group ""Test group"""
  • Los nombres de los parámetros de asignación no distinguen entre mayúsculas y minúsculas (desde la versión 14.0)
  • Se puede especificar la configuración del proxy para la asignación dentro de ASSIGNMENTOPTIONS. Existen ajustes adicionales de proxy para la conexión de TeamViewer (tal y como se define en las opciones del Client de TeamViewer). Éstos tienen que estar fuera de las opciones de asignación.
  • También puedes insertar variables de entorno en tus comandos de instalación/asignación para añadir valores dinámicos, por ejemplo, para el alias. Puedes utilizar variables de entorno utilizando %%.
    msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--alias %COMPUTERNAME%"
Historial de versiones
Revisión n.º
22 de 22
Última actualización:
septiembre
Actualizado por:
 
Colaboradores