Comment facilement exécuter des scripts à distance - Scripts automatisés

Pas d'évaluation

Cet article s'applique aux clients TeamViewer détenant une licence TeamViewer. 

Général

  • Gagnez du temps sur les tâches répétitives en automatisant vos scripts. Charges vos batch, powershell ou shell cryptés dans votre Management Console.
  • Lors des sessions à distance, vous pouvez sélectionner les scripts enregistrés à partir du menu, puis démarrer l'exécution d'un seul clic.
  • Normalisez la maintenance et l'assistance tout en réduisant le temps de résolution.
  • Utilisez le temps ainsi gagné pour vous concentrer davantage sur des tâches importantes et sur la résolution d'autres demandes d'assistance.
  • Retrouvez votre productivité et aidez un plus grand nombre de clients.

Exécution des scripts à distance en un clic - Vidéo d'introduction

Téléchargement des scripts dans TeamViewer Management Console

Tous les scripts que vous voulez utiliser dans une session doivent être téléchargés dans TeamViewer Management Console cryptés sur un stockage dans le Cloud.

Veuillez vous connecter avec votre compte TeamViewer pour commencer.

Exigences pour TeamViewer Management Console

Il existe des conditions préalables que vous devez respecter pour pouvoir automatiser vos tâches avec des scripts. Veuillez vous assurer que vous vous conformez à toutes :

  • Pour utiliser des scripts, vous devez posséder une licence valide pour TeamViewer 14.
  • Les scripts sont prêts à être utilisés et enregistrés sur les dossiers locaux ou réseau dans un fichier.
  • La taille du fichier de script est inférieure à 100 Ko.

Procédure de téléchargement dans TeamViewer Management Console

Vous pouvez administrer vos scripts dans Management Console en cliquant sur l'élément de menu Scripts  sous Accueil dans le coin supérieur gauche. 

Scipt1.png

Si vous débutez dans l'utilisation de scripts, vous pouvez simplement démarrer l'ajout d'un script à partir de la page d'informations avec le bouton Ajouter un script .  Script2.pngSi vous avez déjà téléchargé certains scripts, ils sont affichés dans un tableau. 

Script3.png

 

Le bouton Ajouter un script en haut du tableau fournit un nouveau menu pour ajouter des informations supplémentaires sur le script et pour sélectionner un fichier de script. 

1_Add_Script.png

Nom et description

Vous pouvez ajouter un nom court et une description évocatrice plus longue pour votre script. Le nom est utilisé pour le menu dans la session, tandis que la description s'affiche comme astuce sur l'outil pour une entrée de menu de script, pour que vous puissiez fournir des informations sur les actions du script.

Si vous n'ajoutez pas de nom, le nom de script (sans la fin du fichier ) est pris par défaut lors de la sélection du fichier.

Système d'exploitation

En choisissant le système d'exploitation, vous visualisez uniquement ces scripts dans le menu de vos sessions, pouvant être exécutés sur le système d'exploitation de la machine distante à laquelle vous êtes connecté.

WindowsmacOS et Linux sont actuellement pris en charge.

Exécuter en tant qu'administrateur

Si votre script utilise au moins une commande, nécessitant des droits d'administration (mode élevé sous Windows), vous devez vérifier l'exécution Exécuter en tant qu'administrateur.

Lorsque vous démarrez un script, on vous demande seulement une fois l'autorisation avant le lancement de l'exécution (si l'utilisateur connecté dispose déjà de droits d'administration) ou encore les identifiants d'administration (si l'utilisateur connecté ne dispose pas de droits d'administration), quelle que soit la fréquence et le moment où ces commandes sont utilisées dans votre script (comme pour les tâches longues).

(warning) À l'heure actuelle, vous êtes uniquement en mesure d'exécuter les en tant qu'administrateur sur la solution TeamViewer installée. Sous Windows L'option Exécuter uniquement (utilisation ponctuelle) ou QuickSupport n'est pas possible, car l'invite UAC ne peut pas être affichée côté client.

(warning) Les scripts en mode administrateur ne sont pas encore pris en charge pour Linux.

Types de scripts

Les types de scripts suivants sont actuellement pris en charge

  • Sous Windows
    • Batch (.bat, .cmd)
    • PowerShell (.ps1)
  • Sous macOS
    • Shell (.sh)
  • Sous Linux
    • Bash (.sh)

Enregistrer

Si vous cliquez sur le bouton Enregistrer, votre fichier de script est téléchargé crypté sur le stockage dans le Cloud. Vos données de script et le lien vers votre fichier de script sont également stockés cryptés.

Mettre à jour

Vous pouvez modifier et supprimer les scripts existants en sélectionnant la fonction Editer ou Supprimer dans le menu contextuel d'un élément de script. Le menu contextuel est affiché si vous passez la sur la fin du tableau : Script5.PNG

Si vous modifiez un fichier de script existant ou les données de script, le fichier ou les données modifiés sont enregistrés au lieu des anciennes données. L'ancien fichier de script est supprimé du stockage Cloud.

Exécution de script dans vos sessions

Si vous démarrez une sessionTeamViewer, vous avez accès à vos scripts dans un nouveau menu de script.

Exigences

Il existe des exigences qui doivent être respectées avant de pouvoir automatiser vos tâches avec des scripts. Veuillez vous assurer que vous vous conformez à toutes :

  • Pour utiliser des scripts, vous devez posséder une licence valide pour TeamViewer 14 et l'avoir installé (pour Linux, la version 14.2 ou supérieure est requise)
  • La solution TeamViewer version 14 doit être installée sur le système distant auquel vous êtes connecté.
  • Vous devez être connecté au client TeamViewer avec votre compte sous licence (sinon vos scripts ne s'affichent pas pour la session).
  • Les scripts que vous voulez exécuter sur la machine distante doivent être signalés comme adaptés au système d'exploitation de la machine distante.
  • Pour Windows : Le client TeamViewer côté distant doit être installée (non démarré avec l'option Exécuter uniquement). Sinon, lors de l'exécution de scripts nécessitant des droits d'administration, l'invite UAC ne peut pas être visible sur le client de connexion.
  • Une connexion HTTP à partir du système d'exploitation vers le stockage dans le Cloud doit être possible.
  • (warning) Malheureusement, avec le nouveau contrôle d'accès pour l'exécution du script, nous avons dû rompre la compatibilité entre 14.0 / 1 et 14.2. Pour vous assurer que les scripts peuvent être utilisés, assurez-vous que vous avez des deux côtés, client et serveur, TeamViewer 14.0 / 14.1 installé ou 14.2. Une version 14.0 / 14.1 connectée à 14.2 ou inversement ne fonctionnera pas.

Exécution de script

  • Établissez une connexion TeamViewer une fois que les exigences décrites ci-dessous ont été respectées.
  • Ouvrez le menu de script.
    • Windows : Dans la barre d'outils client, accédez à Actions et cliquez sur le bouton Scripts pour ouvrir le menu.Script6.png

       

    • macOS : Dans la barre de menu, accédez à Scripts.script7.png

       

  • Tous vos scripts téléchargés pour le système d'exploitation de votre machine distante sont présentés dans le menu affiché.
  • Sélectionnez un script à exécuter sur la machine distante en cliquant sur le menu contextuel.
  • Une fois par session : l'utilisateur distant doit accepter la boîte de dialogue de demande d'exécution de script .
  • Le script est téléchargé sur la machine distante depuis le stockage dans le Cloud, puis décrypté et démarré.
  • S'il a besoin de droits d'administration, une boîte de dialogue s'affiche, demandant l'autorisation.
  • Côté distant, certaines notifications sont affichées pour le statut en cours.

Gestion des autorisations (en particulier pour les appareils non surveillés)

(warning) Le paramètre d'autorisation a changé dans la version 14.2. Si vous utilisez toujours TV 14.0 ou 14.1, veuillez vous reporter à la section ci-dessous.

Par défaut, les scripts peuvent uniquement être exécutés si l'utilisateur côté distant accepte la demande d'exécution. Pour les appareils non surveillés, il n'y a aucun utilisateur qui peut confirmer la demande.

Pour cela, vous avez la possibilité de désactiver la demande de confirmation via les options/préférences ou via les stratégies TeamViewer ou bien de toujours refuser les executions de scripts via une nouvelle prise en main.

Il est non seulement possible pour la session entrante de définir l’autorisation, mais également pour les connexions sortantes. Comme ce paramètre ne peut être modifié que si vous disposez de droits d'administrateur sur votre ordinateur, vous pouvez utiliser ce paramètre pour restreindre l'exécution des scripts pour les employés "non-autorisés" de votre société.

Si vous choisissez un contrôle d'accès, les valeurs par défaut sont définies de la manière suivante :

Contrôle d'access Execution du scipt
Accès intégral Après confirmation
Confirmer tout Après confirmation
Visualiser et montrer Refusé
Paramètres personnalisés Après confirmation
Refuser les sessions de contrôle à distance entrantes Refusé

 

Pour les paramètres personnalisés, vous pouvez définir vous-même la valeur de votre choix :

Valeur pour l'exécution du script Description
Refusé L'exécution de script n'est pas autorisée sur cet appareil
 Après confirmation L'exécution du script n'est autorisée qu'après que l'exécution a été validée du côté distant
Accepté L'exécution de script est toujours autorisée sur cet appareil sans confirmation supplémentaire

Windows

Sous Windows, ouvrez le client TeamViewer et accédez à Suppléments --> Options dans le menu. Sélectionnez l'onglet Avancé et faites défiler vers le bas vers la section Paramètres avancés pour les connexions à cet ordinateur ou Paramètres avancés pour les connexions à d'autres ordinateurs.

3_MacOS_Options.png

macOS

Sous macOS, ouvrez le client TeamViewer et accédez à Préférences dans le menu. Sélectionnez l'onglet Avancé et faites défiler vers le bas vers la section Paramètres avancés pour les connexions à cet ordinateur ou Paramètres avancés pour les connexions à d'autres ordinateurs.

script9.png

Linux

Sous Linux, ouvrez le client TeamViewer et accédez à Suppléments --> Options dans le menu. Sélectionnez l'onglet Avancé et faites défiler vers le bas vers la section Paramètres avancés pour les connexions à cet ordinateur.

Vous ne disposez que des paramètres pour les connexions à cet ordinateur, car les scripts de démarrage à partir d'une machine Linux ne sont pas encore disponibles.

4_Linux_Options.png

Management Console

Il est maintenant également possible de transférer les paramètres via la Management Console vers plusieurs appareils à la fois.

Il vous suffit de définir votre stratégie dans la Management Console et de l’affecter aux appareils de votre liste d'Ordinateurs et contacts.

  1. Définissez votre stratégie dans la section Configurer & déployer5_Policy.png
  2. Affectez votre stratégie à vos appareils6_Apply_policy.png

Gestion des autorisations pour TeamViewer 14.0 / 14.1

Dans les options/préférences, vous avez la possibilité de désactiver la demande de confirmation pour cette installation de TeamViewer avec le paramètre Autoriser l'exécution de script sans confirmation.

(warning) Ce paramètre n'est plus disponible avec la version TeamViewer 14.2 (ou ultérieure). Aucune migration automatique n'est effectuée.

Windows

Sous Windows, ouvrez le client TeamViewer et accédez à Suppléments --> Options dans le menu. Sélectionnez l'onglet Avancé et faites défiler vers le bas vers la section Paramètres avancés pour les connexions à cet ordinateur

script8.PNG

macOS

Sous macOS, ouvrez le client TeamViewer et accédez à Préférences dans le menu. Sélectionnez l'onglet Avancé et faites défiler vers le bas vers la section Paramètres avancés pour les connexions à cet ordinateur.

Cochez le nouveau paramètre Autoriser l'exécution de scripts sans aucune confirmation et quittez en cliquant sur Appliquer

script9.png

Les scripts ne sont pas disponibles dans une session

Si vous ne pouvez pas exécuter de scripts dans une session, quelle que soit la raison, alors le menu de script est affiché, mais il est désactivé. Si vous passez votre souris dessus, vous pouvez trouver la raison dans l'infobulle qui s'ouvre.

Windows

Cochez le nouveau paramètre Autoriser l'exécution de scripts sans aucune confirmation et quittez en cliquant sur OK

script10.png

macOS

script11.png

Astuces pour rédiger vos scripts

Utiliser '~' pour les chemins sur macOS

Sur macOS, vous pouvez utiliser ‘~’ pour accéder au répertoire personnel de l’utilisateur. Si les scripts sont exécutés avec des droits d'administration, le script est exécuté par l'utilisateur racine. Par conséquent, "~" sera remplacé par /var/root et non par le répertoire de base de l'utilisateur connecté.

De plus, la variable $HOME n'est pas définie dans ce cas. Pour ces raisons, nous vous recommandons de ne pas utiliser ‘~’ et à $HOME si vous exécutez vos scripts en tant qu’administrateur.

Si vous devez créer, copier ou télécharger des dossiers ou des fichiers, vous pouvez utiliser le répertoire de travail du script exécuté situé sous ~/Library/Application Support/TeamViewer/Remote Scripting/<script-uuid>.

Ce répertoire sera supprimé juste après la fin du script exécuté.

Ces fichiers et dossiers sont également créés par l'utilisateur racine. Si nécessaire, vous pouvez changer le propriétaire avec la commande chown et changer les droits avec chmod.

Utiliser les bonnes fins de ligne

Il est important que vous utilisiez dans vos fichiers de script des fins de ligne correctes, pour assurer une bonne interprétation par système d'exploitation sur lequel vous exécutez les scripts.

Par exemple, un fichier de script contenant «CR LF», comme sous Windows, ne peut pas être exécuté sous Linux (dans ce cas «LF»).

FAQ

Pourquoi mon script Powershell n'est-il pas exécuté sur la machine distante, mais fonctionne parfaitement en local ?

    • Sous Windows, l'exécution de scripts Powershell est par défaut restreinte. Vous devez d'abord modifier la  stratégie d'exécution.
    • Actuellement, sur les ordinateurs 64 bits, le processus 32 bits de la ligne de commande est utilisé. Pour cela, vous devez définir l'autorisation en mode 32 bits :
    • Pour en savoir plus, veuillez consulter la documentation relative à l'obtention de la stratégie d'exécution et à la définition de la stratégie d'exécution 
Historique des versions
Numéro de la révision
8 de 8
Dernière mise à jour :
‎28 août 2019, 11:40 AM
Mis à jour par :
 
Étiquettes (4)
Contributeurs