Comment déployer TeamViewer sur vos appareils macOS ?

Pas d'évaluation

Cet article s'applique à tous les clients TeamViewer possédant un abonnement Corporate ou Tensor utilisant la version 14.x

Versions macOS compatibles : 10.11, 10.12, 10.13, 10.14

Cet article explique comment installer, mettre à jour, désinstaller TeamViewer Host et la version complète dans un contexte de déploiement de masse sous macOS.

Astuce : Il n'est pas possible de pousser des options pendant l'installation de TeamViewer sur macOS.

Astuce : L'installation silencieuse n'est pas encore possible sous macOS.

Installation

Pour macOS TeamViewer propose deux fichiers d'installation:

  1. TeamViewer.pkg: installe la version complète de TeamViewer
  2. TeamViewerHost.pkg: installe le module Host (personnalisé) de TeamViewer

Pour le Host Standard

Pour installer TeamViewer dans un scénario de déploiement en masse sans interaction de l'utilisateur, vous devez utiliser la commande suivante à partir de votre script, directement à partir du terminal ou de votre solution de déploiement:

  • Tapez dans le terminal: sudo installer -pkg "Installer TeamViewerHost.pkg" -target /
    Le paramètre -target définit le chemin où vous souhaitez que votre installation soit située.
sudo installer -pkg "Install TeamViewerHost.pkg" -target /

Pour le Host personnalisé

Pour installer le Host personnalisé, merci de suivre les étapes suivantes :

  1. Créez un Host personnalisé ou ouvrez un Host personnalisé existant sur votre Management Console.

    Pour personnaliser votre Host : Rendez-vous sur Configurer et déployer pour configurer votre personnalisation dans la Management Console. Après avoir créé le Host, un ID de configuration sera généré. Vous pouvez le trouver en cliquant sur Éditer.
    massdeployment2.png

  2. Copiez le Configuration ID de votre Host personnalisé.
  3. Ouvrez le terminal ou exécutez le programme via un script.
  4. Ajoutez le Configuration ID au nom du fichier .pkg dans votre ligne de commande:
    sudo installer -pkg "Install TeamViewerHost-idc<ConfigurationID>.pkg" -target /


Résumé des paramètres

Paramètre

Description

-idc

L'ID de configuration est nécessaire pour installer un Host personnalisé. Il ne peut pas être utilisé pour configurer une installation de la version complète. L'ID de configuration peut être récupéré à partir de la Management Console.

 

Pour la version complète

Pour installer la version complète, merci de suivre les étapes suivantes :

  1. Ouvrez le terminal ou exécutez le programme via un script.
  2. Entrez dans votre terminal la commande suivante : sudo installer -pkg "Install TeamViewer.pkg" -target /
    sudo installer -pkg "Install TeamViewer.pkg" -target /
    Le paramètre -target définit le chemin où vous souhaitez que votre installation soit située.

Installation silencieuse du Host personnalisé

Note : L'installation silencieuse n'est prise en charge que pour le Host personnalisé pour le moment. La prise en charge du client complet est prévue dans un proche avenir.

Pour installer TeamViewer dans un scénario de déploiement en masse en mode silencieux (sans interaction humaine), procédez comme suit :

  1. Téléchargez le package PKG du Host à partir de notre site web :
    1. Téléchargez TeamViewerHost.dmg
    2. Si vous avez téléchargé le fichier DMG sur un ordinateur Windows, vous pouvez extraire le fichier PKG à partir du DMG à l'aide d'un outil ZIP. (e.g. 7ZIP)
      1. Le package d'installation se trouve dans le dossier "...\TeamViewerHost.dmg\TeamViewerHost\"
      2. Si vous avez téléchargé le package sur un Mac, il vous suffit simplement de double-cliquer sur le package DMG "Install TeamViewerHost.pkg".
  2. Générez un fichier XML que vous appelez par exemple choices.xml et entrez l'entrée suivante :
    <?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>

    le choiceIdentifier "com.teamviewer.teamviewerhost14SilentInstaller" est uniquement valable pour la version 14 de TeamViewer. Celui-ci peut changer pour les versions antérieures.

  3. Vérifier si votre configuration sera appliquée correctement (optionnel)
    1. Exécutez la commande suivante :
      installer -showChoicesAfterApplyingChangesXML newChoices.xml -pkg Install\ TeamViewerHost.pkg -target /
    2. Cela donnera un résultat qui devrait ressembler à ceci :
      <?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. Appliquez la configuration lors de l'installation en ajoutant le paramètre "-applyChoiceChangesXML <votre_fichier> .xml"
    1. Exemple pour un Host standard :
      sudo installer -applyChoiceChangesXML choices.xml -pkg Install\ TeamViewerHost.pkg -target /
    2. Exemple pour un Host personnalisé :
      sudo installer -applyChoiceChangesXML choices.xml -pkg "Install TeamViewerHost-idc<ConfigurationID>.pkg" -target /
  5. Si vous souhaitez déployer sous macOS Mojave :
    1. Accédez à votre solution MDM, par exemple Mobile Iron, JAMF Pro, VMWare ou Mirador
    2. Configurez votre MDM pour déployer les autorisations d'accessibilité (selon le manuel de votre fournisseur de solution MDM)
      1. Vous trouverez un exemple de configuration MDM à l'aide de Mobile Iron: Add TeamViewer apps to macOS Mojave accessibility with Mobile Iron

Affecter le Host ou la version complète à un compte

Le Host

Pour affecter votre Host à un compte, vous avez deux possibilités:

  1. Personnalisez votre module Host de manière à ce qu'il soit automatiquement ajouté à votre compte TeamViewer.
  2. Installez TeamViewer comme décrit ci-dessus. Ensuite, vous pouvez démarrer le processus d’affectation. Veuillez lire la section Affectation au compte pour plus d'informations.

La version complète

Pour affecter votre Host à un compte, vous devez :

  • Installer TeamViewer comme décrit ci-dessus. Puis, vous pouvez commencer la procédure d'affectation au compte. Rendez-vous y directement: Affectation au compte

Mise à jour de TeamViewer

Mettre à jour TeamViewer sur macOS est une procédure normale d'installation. Vous trouverez toutes les informations nécessaires dans la rubrique Installation.

Désinstaller TeamViewer

You can uninstall your TeamViewer (e.g., if you want to switch from a host to a full version) only manually in two ways:

Vous pouvez désinstaller votre TeamViewer de deux manières :

  1. (recommandé) Téléchargez et installez AppCleaner depuis l'App Store:
    1. Ouvrez AppCleaner à partir du Finder.
    2. Cliquez sur Applications dans le menu de gauche.
    3. Faites glisser l'application TeamViewer dans AppCleaner.
    4. Cliquez sur Supprimer.
    5. Entrez votre mot de passe et cliquez sur OK.
    6. Le programme a été désinstallé.
  2. Faites glisser l’application de votre dossier Applications vers la corbeille. Si vous y êtes invité, entrez votre mot de passe et cliquez sur OK.

Affectation au compte

TeamViewer doit déjà être installé (et l'option "Démarrer avec le système" doit également être activée) avant de pouvoir effectuer l'affectation sur macOS. L'outil d'affectation est installé avec l'application sous /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment.

Pour faire l'affectation au compte, merci de suivre les étapes suivantes :

  1. (optionnel) Lancez le TeamViewer service process (uniquement nécessaire si l'utilisateur est connecté via ssh) :
    sudo launchctl load /Library/LaunchDaemons/com.teamviewer.teamviewer_service.plist
     
  2. Exécutez l'outil d'attribution avec les privilèges sudo sur tous les appareils que vous voulez affecter. Pour ce faire, nous vous conseillons d'utiliser un script pour appeler l'outil d'affectation avec les paramètres requis.
    1. Pour le Host standard :
      sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group <GROUP> -alias <COMPUTERNAME> -grant-easy-access
    2. Pour le Host personnalisé :
      sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token $YourToken -grant-easy-access
    3. Pour la version complète :
      sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN>

Si l'outil d'affectation a été exécuté avec succès sur appareil, celui-ci est affecté au compte qui a créé le module Host personnalisé et un accès facile à l'appareil est (éventuellement) activé.

Options d'affectation

Le tableau suivant indique les options possibles pour l’affectation (elles sont toutes facultatives). Certains paramètres nécessitent une valeur (–alias MyAlias), d'autres ne nécessitent pas de valeur (–reassign). Les options doivent être ajoutées à la ligne de commande.

Option

Description

-api-token <TOKEN>

Le jeton API sert à faire l'affectation au bon compte

-alias [<name>]

Alias for the new device in the computers & contacts list. If the device is already in the contact list, the alias will be overwritten. The parameter can take the following values:

  1. -alias (sans valeur) → L'alias de l'ordinateur sera l'ID TeamViewer
    sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -alias -group MyGroup
  2. -alias bonjour → L'alias de l'ordinateur sera "bonjour"
    sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -alias bonjour -group MyGroup
  3. alias non spécifié → L'alias de l'ordinateur sera %nomdel'appareil%
    sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group MyGroup

-grant-easy-access

Cette option accordera l'accès facile à l'appareil (identique à l'option "Accorder un accès facile" dans la fenêtre principale de TeamViewer).
sudo
/Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -grant-easy-access -group MyGroup

-reassign

Affecte l'appareil au compte même si l'appareil est déjà affecté à un compte.
sudo
/Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -eassign -group MyGroup

-group <name>

Nom du groupe dans lequel le périphérique sera ajouté. Si le groupe n'existe pas, il sera automatiquement créé. Si l'appareil est déjà présent dans la liste des Ordinateurs et contacts dans un groupe différent, il ne sera pas déplacé vers ce groupe.
sudo
/Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group MyGroup

Requis uniquement pour le Host standard, car pour le Host personnalisé, il vous sera déjà demandé d'affecter le Host à un groupe par défaut.

-group-id <ID>

Cette option est une alternative au -group, si l'ID du groupe est connue. Cette alternative peut être utile dans pour un déploiement comportant un grand nombre d'appareils, car cette méthode est plus rapide. Notez que le -group-id doit être précédé par la lettre g.
sudo
/Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group-id g123

wait <seconds>

Avec ce paramètre, le temps d'attente pour l'affectation peut être spécifié en secondes. La valeur par défaut de 30 (secondes) devrait normalement suffire.
sudo
/Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -wait 45 -group MyGroup

-proxy <name>:<port>

L'URL de votre proxy (seulement pour l'affectation au compte) sous le format suivant :
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 without http://

-proxy-user <name>

Précisez le nom d'utilisateur qui est utilisé pour l'authentification du proxy (uniquement pour l'affectation au compte)
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>

Précisez le mot de passe qui est utilisé pour l'authentification du proxy (uniquement pour l'affectation au compte)
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>

C'est la même fonction que pour le --proxy-pw. Il est utilisé pour les mots de passe à caractères spéciaux (Base 64). 
sudo
/Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -proxy yourproxy:3201 -proxy-user FooBar -proxy-pw-base64 bXlwYXNz -group MyGroup

Attention: sur macOS, les options de ligne de commande doivent être utilisées avec - au lieu de -- Exemple: -alias (pas --alias)

Informations supplémentaires à propos des options d'affectation

  • Si vous avez des espaces dans votre ligne de commande, utilisez des _ (par exemple pour les noms de groupes) : "<GROUPE_AVEC_ESPACES>".
  • Faites attention aux majuscules/minuscules
  • Les paramètres de proxy peuvent être spécifiés pour l'affectation dans les ASSIGNMENTOPTIONS. Il existe des paramètres de proxy supplémentaires pour la connexion TeamViewer elle-même (comme défini dans les options du client TeamViewer). Celles-ci doivent être définies en dehors des ASSIGNMENTOPTIONS.
  • Vous pouvez spécifier des variables à votre ligne de commande concernant l'installation (ou l'affectation au compte) et y ajouter des valeurs dynamiques en utilisant $, par exemple pour l'alias.
    Les caractères suivants ne doivent pas figurer dans les variables: $, @, `, ´
    Exemple: 
    • group=Test -alias ="$group" fonctionne
      group=Test$ -alias="$group" - ne fonctionne pas
  • Les variables doivent toujours être utilisées entre guillemets.

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

 

Historique des versions
Numéro de la révision
20 de 20
Dernière mise à jour :
‎26 août 2019, 2:15 PM
Mis à jour par :
 
Contributeurs