Implementación masiva en macOS

No hay clasificaciones

Este artículo se aplica a todos los clientes de TeamViewer con un plan de suscripción Corporativo o Tensor que utilicen la versión 14.x.

Versiones de macOS compatibles: 10.11, 10.12, 10.13, 10.14

Este artículo explica cómo puedes instalar, actualizar y desinstalar TeamViewer Host y TeamViewer Full en un escenario de implementación masiva en macOS.

Aviso: No está disponible papa proporcionar ajustes dentro del proceso de instalación en macOS.

Hint: Todavía no es posible realizar despliegues silenciosos en macOS.

Instalación

Para macOS TeamViewer ofrece dos instaladores:

  1. TeamViewer.pkg: instalará la versión completa de TeamViewer
  2. TeamViewerHost.pkg: instalará el módulo de Host (personalizable) de TeamViewer

Cient de Host estándar

Para instalar TeamViewer en un escenario de implementación masiva sin interacción del usuario, debes utilizar el siguiente comando desde tu script, directamente desde el terminal o en tu solución de implementación:

  1. Ingresa en el terminal: sudo installer -pkg "Install TeamViewerHost.pkg" -target /
    El parámetro -target define el destino en el que quieres que se encuentre localizada tu instalación.
    sudo installer -pkg "Install TeamViewerHost.pkg" -target /

Cient de Host personalizado

Cuando quieras instalar un Host personalizado, deberás seguir estos pasos:

  1. Crea una nueva personalización o abre una existente en la Management Console.

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

    0_host.png

  2. Copia la ID de configuración de tu Host personalizado.
  3. Abre el terminal o ejecuta el pkg a través del script.
  4. Añade la ID de configuración al nombre del archivo en la línea de comandos:
    sudo installer -pkg "Install TeamViewerHost-idc<ConfigurationID>.pkg" -target /

Resumen de parámetros

Parámetro

Descripción

-idc

La ID de configuración se necesita para instalar un Host personalizado. No se puede utilizar para configurar la instalación del client completo. La ID de configuración se puede recuperar desde la sección Management Console.

Client completo

Para instalar TeamViewer en un escenario de implementación masiva, debes seguir estos pasos:

  1. Abre el terminal o ejecut pkg a través del script.
  2. Ingresa en el terminal: sudo installer -pkg "Install TeamViewer.pkg" -target /
    sudo installer -pkg "Install TeamViewer.pkg" -target /
    El parámetro -target define el destino en el que quieres que se encuentre localizada tu instalación.

Instalación silenciosa de un client Host (personalizado)

La instalación silenciosa sólo es compatible con el Host (personalizado) por el momento. El soporte para el client completo está previsto para un futuro próximo.

Para instalar TeamViewer en un escenario de despliegue masivo de forma silenciosa (sin supervisión), segue estos pasos:

  1. descarga el paquete Host PKG de la página web de TeamViewer:
    1. descarga TeamViewerHost.dmg
    2. Si has descargado el archivo DMG en un dispositivo Windows, puedes extraer el archivo PKG de DMG con la ayuda de alguna herramienta de ZIP (por ej. 7ZIP)
      1. El paquete "Install TeamViewerHost.pkg" se puede encontrar en la carpeta"...\TeamViewerHost.dmg\TeamViewerHost\" dentro del paquete de DMG
      2. si has descargado el paquete DMG en un Mac, puedes extraer el paquete "Install TeamViewerHost.pkg" haciendo doble clic en el paquete DMG. La ventana de instalación de macOS se abrirá y podrás arrastrar y soltar el paquete "Install TeamViewerHost.pkg" directamente al escritorio.
  2. genera un archivo XML file llamado (p.ej.: choices.xml) e introduce el siguiente contenido:
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <array>
        <dict>
            <key>attributeSetting</key>
            <integer>1</integer>
            <key>choiceAttribute</key>
            <string>selected</string>
            <key>choiceIdentifier</key>
            <string>com.teamviewer.teamviewerhost14SilentInstaller</string>
        </dict>
    </array>
    </plist>

    El identificador choice "com.teamviewer.teamviewerhost14SilentInstaller" solo es válido para la versión 14 de TeamViewer. El esquema de nombres puede cambiar para versiones posteriores.

  3. (opcional) verificar si la configuración se aplicará correctamente:
    1. ejecuta el siguiente comando:
      installer -showChoicesAfterApplyingChangesXML newChoices.xml -pkg Install\ TeamViewerHost.pkg -target /
    2. esto creará una salida que debería ser similar a esta:
      <?xml version="1.0" encoding="UTF-8"?>
      <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
      <plist version="1.0">
      <array>
          <dict>
              ...
          </dict>
          <dict>
              ...
          </dict>
          <dict>
              <key>attributeSetting</key>
              <false/>
              <key>choiceAttribute</key>
              <string>visible</string>
              <key>choiceIdentifier</key>
              <string>com.teamviewer.teamviewerhost14SilentInstaller</string>
          </dict>
          <dict>
              <key>attributeSetting</key>
              <true/>
              <key>choiceAttribute</key>
              <string>enabled</string>
              <key>choiceIdentifier</key>
              <string>com.teamviewer.teamviewerhost14SilentInstaller</string>
          </dict>
          <dict>
              <key>attributeSetting</key>
              <integer>1</integer>
              <key>choiceAttribute</key>
              <string>selected</string>
              <key>choiceIdentifier</key>
              <string>com.teamviewer.teamviewerhost14SilentInstaller</string>
          </dict>
      </array>
      </plist>
  4. aplica la configuración durante la instalación añadiendo el parámetro "-applyChoiceChangesXML <your_filename>.xml"
    1. ejemplo para un Host estándar:
      sudo installer -applyChoiceChangesXML choices.xml -pkg Install\ TeamViewerHost.pkg -target /
    2. ejemplo para un Host personalizado:
      sudo installer -applyChoiceChangesXML choices.xml -pkg "Install TeamViewerHost-idc<ConfigurationID>.pkg" -target /
  5. en caso de que quieras implementar en macOS Mojave:
    1. Vete a tu solución MDM, p.ej. Mobile Iron, JAMF Pro, VMWare o Mirador
    2. Configura tu MDM para desplegar los permisos de accesibilidad (de acuerdo con el manual de su proveedor de soluciones MDM)
      1. un ejemplo de una configuración MDM utilizando Mobile Iron se puede encontrar aquí: Add TeamViewer apps to macOS Mojave accessibility with Mobile Iron

Asigna tu Host o client completo a una cuenta

Host

Para asignar su Host a una cuenta, tienes dos posibilidades:

  1. Personaliza tu módulo TeamViewer Host de tal manera que tu módulo Host se añada automáticamente a la cuenta de TeamViewer. 
  2. Instala TeamViewer como se ha descrito anteriormente. Después, puedes iniciar el proceso de asignación. Por favor, lee Asignación para recibir información adicional.

Versión completa

Para asignar tu client completo a una cuenta, necesitas:

  1. Instala TeamViewer como se ha descrito anteriormente. Después, puedes iniciar el proceso de asignación. Por favor, lee Asignación para recibir información adicional

Actualización de TeamViewer

Actualizar TeamView en macOS es como una instalación normal. Por lo tanto, puedes consultar la sección "Instalación".

Desinstalar TeamViewer

Puedes desinstalar tu TeamViewer (p.ej., si deseas cambiar de un host a una versión completa) solamente de manera manual de dos maneras:

  1. (recomendada) Descarga e instala AppCleaner de Mac App Store:
    1. Abre AppCleaner y haz clic en el icono de Finder.
    2. Haz clic en aplicaciones en el menu izquierdo.
    3. Arrastra la aplicación de TeamViewer dentro de AppCleaner.
    4. Haz clic en eliminar.
    5. Introduce tu contraseña y haz clic en OK.
    6. Con este paso, el programa ha sido desinstalado.
  2. Arrastra la aplicación desde tu carpeta de aplicaciones a la papelera. Drag the application from your Applications folder to the trash. Si se te solicita, introduce tu contraseña y haz clic en aceptar..

Asignar

TeamViewer debe estar instalado (y para el client completo también la opción "Start with system" debe estar activada) antes de poder realizar la asignación en macOS. La herramienta de asignación se instala con la aplicación en:
/Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment.

Para hacer la asignación, sigue estos pasos:

  1. (opcional) Inicia el proceso de servicio de TeamViewer (sólo es necesario si el usuario ha iniciado sesión a través de ssh):
    sudo launchctl load /Library/LaunchDaemons/com.teamviewer.teamviewer_service.plist
     
  2. Ejecuta la herramienta de asignación con privilegios sudo en todos los dispositivos que deban asignarse. Para hacer esto en un escenario de despliegue masivo, te aconsejamos que utilices un script para llamar a la herramienta de asignación con los parámetros requeridos.

    1. Version Host 
      sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group <GROUP> -alias <COMPUTERNAME> -grant-easy-access
    2. Versión de Host personalizado
      sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token $YourToken -grant-easy-access
    3. Versión completa:
      sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN>

Si la herramienta de asignación se ha ejecutado correctamente en un dispositivo, el dispositivo se asigna a la cuenta que creó el módulo de Host de TeamViewer personalizado y se activa (opcionalmente) el acceso fácil para el dispositivo.

Opciones de asignación

La siguiente tabla muestra las opciones posibles para la asignación (todas son opcionales). Hay algunos parámetros que necesitan un valor (-alias MyAlias) o no necesitan un valor (-reassign). Las opciones deben añadirse a la línea de comandos.

Opción

Descripción

-api-token <TOKEN>

API Token para hacer la asignación a la cuenta correcta

-alias [<name>]

Alias para el nuevo dispositivo en la lista de ordenadores & contactos. Si el dispositivo ya existe en tu lista de contactos, el alias será sobreescrito. El parámetro puede tomar los siguientes valores:

  1. -alias (without value) → alias del ordenador será la ID de TeamVIewer
    sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -alias -group MyGroup
  2. -alias hello → alias del ordenador será "hello"
    sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -alias hello -group MyGroup
  3. alias parameter not specified → alias of del ordenador será %computername%

    sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group MyGroup

-grant-easy-access

Si configuras esta opción, el acceso fácil se concede después de la asignación (igual que la opción "Conceder acceso fácil" en la ventana principal de TeamViewer).

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -grant-easy-access -group MyGroup

-reassign

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

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -reassign -group MyGroup

-group <name>

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

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group MyGroup

Sólo se requiere si no se utiliza ningún host personalizado, debido a que ya 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 el 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 -grupo es suficiente. Ten en cuenta que el ID debe ir precedido de una "g" literal.

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group-id g123

wait <seconds>

Con este parámetro, el tiempo de espera para la asignación se puede especificar en segundos. Por lo general, el valor predeterminado de 30 (segundos) es suficiente.

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -wait 45 -group MyGroup

-proxy <name>:<port>

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

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -proxy yourproxy:3201 -proxy-user FooBar -proxy-pw mypass -group MyGroup

(warning) URL sin http://

-proxy-user <name>

<p">Nombre de usuario que se utiliza para la autenticación contra el proxy (sólo para la asignación). sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -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).

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -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.

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -proxy yourproxy:3201 -proxy-user FooBar -proxy-pw-base64 bXlwYXNz -group MyGroup

 

Ten cuidado: en las opciones de la línea de comandos en macOS hay que usar - en vez de --. Ejemplo: -alias (not --alias)

Ayuda para las opciones de asignación

  • Si tienes valores de parámetros con espacios en blanco (por ejemplo, para el nombre del grupo), usa "<GROUP_NAME_WITH_BLANK>".
  • Los nombres de los parámetros distinguen entre mayúsculas y minúsculas
  • 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 de cliente de TeamViewer). Éstos deben 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. Se pueden utilizar variables de entorno utilizando la anotación $. Las variables no deben contener los siguientes caracteres: $, @, `, @, `, ´
    Ejemplo: 
    • group=Test -alias ="$group" funciona
      group=Test$ -alias="$group" - no funciona
  • Las variables deben utilizarse siempre entre comillas.

    Ejemplo
    1. export GROUP="MyGroup"
    2. export ALIAS="MyDevicename"
    3. sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOAPITOKEN> -group "$GROUP" -alias "$ALIAS"

Historial de versiones
Revisión n.º
8 de 8
Última actualización:
hace un mes
Actualizado por:
 
Colaboradores