Comment déployer TeamViewer sur votre parc informatique ? (nouvelle méthode)

Pas d'évaluation

Cet article s'applique à tous les clients TeamViewer détenant une licence Corporate ou Tensor.

Cet article s'applique à TeamViewer version 13.2 ou supérieure.

Versions Windows supportées : Win 7, Win 8 et Win 10

Cet article explique comment déployer le TeamViewer Host et la version complète de TeamViewer dans contexte de déploiement de masse sous Windows

Installation

Sous Windows, TeamViewer propose deux installations .msi :

  1. TeamViewer_Host.msi : Pour l'installation de votre module TeamViewer Host personnalisé
  2. TeamViewer_Full.msi : Pour l'installation de la version complète

Installation du Host standard

Afin d'installer TeamViewer Host dans un contexte de déploiement de masse sans interaction de l'utilisateur, il vous suffit d'utiliser la commande suivante dans le script que vous utilisez pour votre déploiement :

msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn

La propriété /i indique que vous voulez faire une installation
La propriété /qn permet à l'installation silencieuse du programme. Cela veut dire, qu'aucune interaction ne sera nécessaire pendant l'installation.

L'installation de TeamViewer Host requiert les droits administrateurs. Il existe plus de propriétés concernant le .msi pour gérer votre installation. Pour cela, utilisez la commande : msiexec.exe /?

Installation du Host personnalisé

Pour déployer le Host personnalisé silencieusement, merci de suivre la procédure ci-dessous :

  1. Créer un Host personnalisé ou ouvrez un Host personnalisé existant

    Comment personnaliser votre Host :Connectez-vous à votre Management Console et rendez-vous sur Configurer & Déployer. Cliquez sur Ajouter Host, puis personnalisez votre Host. Maintenant, assurez-vous bien que la case de Autoriser l'affectation du compte via l'outil d'affectation soit bien cochée, puis validez en cliquant sur Enregistrer. Maintenant, réouvrez votre Host, vous devriez avoir votre jeton d'imputation (JETON_API), ainsi que votre ID configuration (ID_CONFIG) affichés comme ci-dessous :1_Customized_Host_Editing.png

  2. Copiez votre ID Config indiqué dans 1.
  3. Ouvrez l'invite de commande Windows (CMD) en l'exécutant avec les droits administrateurs ou exécuter le .msi à l'aide d'un script (batch, etc.).

    La commande (ou le script) doivent être impérativement exécuté en tant qu'administrateur.

  4. Entrez la commande suivante :
    msiexec.exe /i "Chemin\TeamViewer_Full.msi>" /qn CUSTOMCONFIGID=<VOTRE_ID_CONFIG> 
  5. Voici ci-dessous un exemple pour installer le Host personnalisé en l'affectant automatiquement à votre compte et en accordant l'accès facile à ce Host
    msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn CUSTOMCONFIGID=<VOTRE_ID_CONFIG> APITOKEN=<VOTRE_JETON_API> ASSIGNMENTOPTIONS="--grant-easy-access"

Version complète

Pour déployer la version complète silencieusement, merci de suivre la procédure ci-dessous :

  1. Ouvrez l'invite de commande Windows (CMD) en l'exécutant avec les droits administrateurs ou exécuter le .msi à l'aide d'un script (batch, etc.).

    La commande (ou le script) doivent être impérativement exécuté en tant qu'administrateur.

  2. Entrez la commande suivante :
    msiexec.exe /i "Chemin\TeamViewer_Full.msi" /qn
    La propriété /i indique que vous voulez faire une installation
    La propriété /qn permet à l'installation silencieuse du programme. Cela veut dire, qu'aucune interaction ne sera nécessaire pendant l'installation.

À propos du .msi : Afin d'obtenir la liste complète des propriétés du .msi, entrez la commande suivante : msiexec.exe /?

Configuration de la version complète

Lisez cet article pour en savoir plus. (Article en cours d'édition)

Configuration de l'installation

Appliquer les options pré-configurées à votre déploiement

Si vous voulez appliquer des options que vous avez pré-configurées à votre déploiement, merci de suivre la procédure suivante :

  1. Placer votre .reg contenant les options dans le même dossier que le .msi et renommez votre .reg de la manière suivante : TeamViewer_Settings.reg

    Comment obtenir le .reg : Installez TeamViewer sur un appareil et configurez les options comme vous le désirez. Maintenant exportez le fichier. Pour ce faire, merci de suivre les indications suivantes : Suppléments  Options  Avancé  et tout en bas, cliquez sur Exporter les options dans un fichier *.reg. Puis, nommez ce fichier "TeamViewer_Settings.reg"

  2. Ajoutez la propriété IMPORTREGFILE=1 à votre commande. 0  est la valeur par défaut pour IMPORTREGFILE and et n'importera pas vos options.
    msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn IMPORTREGFILE=1


Affecter votre Host ou votre version complète à un compte

Il est judicieux d'affecter ses appareils à son compte lors du déploiement. Pour ce faire, merci de suivre les instruction suivantes :

  1. Ajoutez la propriété ASSIGNMENTOPTIONS="<Nom_de_l'option>" et APITOKEN=<Votre_Apitoken> à votre commande
    msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<Votre_Apitoken> ASSIGNMENTOPTIONS="--group Votre_Groupe"


Liste des propriétés

Propriété

Disponible pour le Host ou la version complète ?

Description

CUSTOMCONFIGID

Host
Version complète

Le Config ID est nécessaire pour installer le Host personnalisé. Il ne peut pas être utilie pour installer la version complète. Le Config ID se trouve dans la Management Console.

DESKTOPSHORTCUTS

Host
Version complète

Détermine si un raccourci de TeamViewer sera créé sur le Bureau. Par défaut : 0 - Dans ce cas aucun raccourci ne sera créé.

APITOKEN

Host
Version complète

Le Jeton API est nécessaire pour l'affectation de l'appareil au compte. Le Jeton API se trouve dans la Management Console.

ASSIGNMENTOPTIONS

Host
Version complète

Les options d'affectation sont nécessaires pour affecter l'appareil à un compte TeamViewer existant. Vous trouverez une liste complète des options d'affectation en bas de cette page.

IMPORTREGFILE

Host
Version complète

La propriété IMPORTREGFILE est utilisée pour importer les options de Teamviewer.
1 - Les options seront importées à partir du fichier "TeamViewer_Settings.reg"
0 - Les options ne seront pas importées.

 

Mise à jour de TeamViewer

À propos du TeamViewer_Host.msi

Si vous voulez installer le TeamViewer Host et que vous avez déjà un TeamViewer installé sur votre appareil, vous devez vérifier si la mise à jour est supportée dans votre cas. Le tableau suivant vous montre dans quels cas de figure une mise à jour est possible et dans quels cas vous devrez désinstaller et réinstaller le programme :

Type d'installation et version déjà existante sur le poste

Comportement lors de l'installation du TeamViewer_Host.msi (TV 14.1)

Solution

Version complète (peu importe la version)

l'installation ne peut être exécutée

  1. Désinstaller le client
  2. Exécuter le .msi

Host (même version que la version installée)

l'installation ne peut être exécutée

  1. Désinstaller le client Host
  2. Exécuter le .msi

Host (version 13.2 et supérieure)

l'installation s'exécuter avec succès

-

Host (version 13.1 et inférieure)

l'installation ne peut être exécutée

  1. Désinstaller le client Host
  2. Exécuter le .msi

À propos du TeamViewer.msi

Si vous voulez installer la version complète de TeamViewer et que vous avez déjà un TeamViewer installé sur votre appareil, vous devez vérifier si la mise à jour est supportée dans votre cas. Le tableau suivant vous montre dans quels cas de figure une mise à jour est possible et dans quels cas vous devrez désinstaller et réinstaller le programme :

Type d'installation et version déjà existante sur le poste

Comportement lors de l'installation du TeamViewer_Host.msi (dernière version)

Solution

Version complète (peu importe la version)

l'installation ne peut être exécutée

  1. Désinstaller le client
  2. Exécuter le .msi

Version complète (14.0 ou supérieur)

l'installation ne peut être exécutée

  1. Désinstaller le client Host
  2. Exécuter le .msi

Version complète (13.2 ou inférieur)

l'installation s'exécuter avec succès

-

Host (peu importe la version)

l'installation ne peut être exécutée

  1. Désinstaller le client Host
  2. Exécuter le .msi


La mise à jour automatique dans TeamViewer n'est plus disponible si vous utilisez le fichier MSI pour l'installation.
Il doit être mis à jour avec Windows Installer à nouveau.

Désinstaller TeamViewer

Vous pouvez désinstaller TeamViewer en

  1. utilisant exactement le même .msi que celui ayant servit pour l'installation
  2. passant par le panneau de configuration Windows

Désinstallation via le .msi

Vous pouvez désinstaller TeamViewer via ligne commande. Assurez-vous d’utiliser le bon MSI (version complète ou Host) pour la désinstallation.

msiexec.exe /uninstall "Chemin\TeamViewer_Host.msi"

Les droits administrateurs sont nécessaires pour exécuter cette ligne de commande.

Affectation

Introduction

Vous pouvez configurer un client TeamViewer de manière à ce qu'il soit affecté à un compte TeamViewer. Cette section va vous expliquer comment procéder.

Cette description est valable pour TeamViewer 14.x et également pour le Host v13.2.

Vous pouvez affecter un appareil à un compte TeamViewer de deux manières différentes:

  1. Avec le programme d'installation .msi (TeamViewer_Full.msi ou TeamViewer_Host.msi)
  2. Avec l'exécutable TeamViewer après l'installation (TeamViewer.exe)

Si vous possédez une version plus ancienne de TeamViewer, vous devez utiliser l'outil d'affectation. Plus d'informations à ce sujet peuvent être trouvées ici.

Comment fonctionne l'affectation

Pour procéder à l'affectation au compte vous avez besoin de :

  1. Un API token (Jeton API) valide
  2. (optionel) les assignment options afin pouvoir définir avec quels paramètres votre TeamViewer va s'installer

    Un API token peut être récupéré de deux manières différentes :
    1. à partir de votre Host personnalisé, si vous avez coché l'option Autoriser l’affectation du compte via l’outil d’affectation lors de la création du Host.
    2. vous pouvez créer un jeton de script dans votre profil d'utilisateur> Applications. Ce jeton de script nécessite au moins les autorisations suivantes:
    Gestion de groupe → Visualiser, créer, supprimer, éditer et partager les groupes
    Ordinateurs et contacts → Afficher, ajouter, modifier et supprimer

Affectation avec le .msi

Afin d'affecter l'appareil au compte, vous devez exécuter votre .msi et ajouter l'API token ainsi que les éventuelles ASSIGNMENTOPTIONS

  • Client Host:
    msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn APITOKEN=<VOTRE_APITOKEN> [ASSIGNMENTOPTIONS="<VOS OPTIONS>"]
  • Version complète
    msiexec.exe /i "Chemin\TeamViewer_Full.msi" /qn APITOKEN=<VOTRE_APITOKEN> [ASSIGNMENTOPTIONS="<VOS OPTIONS>"]

Affectation avec l'exécutable (TeamViewer.exe)

Vous pouvez également effectuer l'affectation après l'installation du client TeamViewer. Il est important que TeamViewer soit démarré sur la machine que vous souhaitez affecter.

Appelez TeamViewer.exe (ou simplement Teamviewer) avec la commande "assign", suivie de la propriété --api-token et de vos options d'affectation:

TeamViewer.exe assign --api-token <VOTRE_APITOKEN> [--group-id <GROUP_ID> --grant-easy-access --reassign --proxy <VOTRE_PROXY> --proxy-user <VOTRE_PROXY_USER> --proxy-pw <MOTDEPASSE>]

Les options d'affectation

Option

Description

--alias [<nom>]

C'est le nom d'affichage d'un appareil dans votre liste d'Ordinateurs et contacts. Si l'appareil existe déjà, l'alias du déploiement va écraser l'alias de l
appareil existant. Le paramètre peut être écrit sous les formes suivantes :

  1. --alias (sans valeur) → l'alias du poste sera son ID TeamViewer
    msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn APITOKEN=<VOTRE_APITOKEN> ASSIGNMENTOPTIONS="--alias --group MyGroup"
  2. --alias bonjour → l'alias du poste sera "bonjour"
    msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--alias bonjour --group MyGroup"
  3. alias non specifié → l'alias de cet appareil sera son nom système

    msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn APITOKEN=<VOTRE_APITOKEN> ASSIGNMENTOPTIONS="--group MyGroup"

--grant-easy-access

Si vous paramétrez cette option, l'accès facile sera activé sur vos postes déployés.

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

--reassign

Affecte l'appareil à votre compte, même si il est déjà affecté à un autre compte.

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

--group <name>

Définit dans quel groupe l'appareil déployé sera ajouté. Si le groupe n'existe pas encore, le groupe sera automatiquement créé. Si l'appareil est déjà présent dans un autre groupe, l'appareil ne sera pas déplacé et restera dans le groupe d'origine. En revanche, si vous utilisez l'option --reassign, l'appareil sera déplacé dans le nouveau groupe.

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

Cela n'est pas nécessaire pour le déploiement du Host, car le groupe est déjà définissable lors de la création du Host.

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

Pour retrouver le group-id connectez-vous à votre Management Console, cliquez sur le groupe en question, le group-id sera dans l'URL de votre navigateur. Vous trouverez g/12345678.

Retirez le / pour obtenir votre group-id.

msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn APITOKEN=<VOTRE_APITOKEN> ASSIGNMENTOPTIONS="--group-id g123"

--proxy <nom>:<port>

L'URL de votre proxy (seulement pour l'affectation au compte) sous le format suivant :

msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn APITOKEN=<VOTRE_APITOKEN> ASSIGNMENTOPTIONS="--proxy votreproxy:3201 --proxy-user FooBar --proxy-pw mypass --group MyGroup"

(warning) URL sans http://

--proxy-user <nom>

Précisez le nom d'utilisateur qui est utilisé pour l'authentification du proxy (uniquement pour l'affectation au compte)

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

--proxy-pw <motdepasse>

Précisez le mot de passe qui est utilisé pour l'authentification du proxy (uniquement pour l'affectation au compte)

msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn APITOKEN=<VOTRE_APITOKEN> ASSIGNMENTOPTIONS="--proxy votreproxy:3201 --proxy-user FooBar --proxy-pw mypass --group MyGroup"

--proxy-pw-base64 <motdepasse_encodé>

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

msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn APITOKEN=<VOTRE_APITOKEN> ASSIGNMENTOPTIONS="--proxy votreproxy:3201 --proxy-user FooBar --proxy-pw-base64 bXlwYXNz --group MyGroup"

 

Informations supplémentaires concernant les options d'affectation

  • Si vous avez des espaces (par exemple dans votre nom de groupe), utilisez des doubles guillemets pour les encadrer.
    msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn APITOKEN=<VOTRE_APITOKEN> ASSIGNMENTOPTIONS="--group ""Test group"""
  • Le système ne fait aucune différence entre minuscules et majuscules (depuis la version 14.0)
  • Les paramètres de proxy peuzvent être specifiés dans les ASSIGNMENTOPTIONS. Il y a aussi des paramètres proxy supplémentaires, qui eux, doivent être spécifiés en dehors des ASSIGNMENTOPTIONS.
  • You can also insert environment variables to your commands for installation/assignment to add dynamic values, e.g. for the alias. You can use environment variables by using %%.
    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 %%.
    msiexec.exe /i "Chemin\TeamViewer_Host.msi" /qn APITOKEN=<VOTRE_APITOKEN> ASSIGNMENTOPTIONS="--alias %NOM_ORDINATEUR%"
Historique des versions
Numéro de la révision
26 de 26
Dernière mise à jour :
il y a un mois
Mis à jour par :
 
Contributeurs