Objets WSH (Windows Scripting Host)

D├ęcembre 2016

WSH

Windows Scripting Host (WSH) est un hôte de scripts pour les systèmes Microsoft Windows permettant d'interprêter des scripts afin d'automatiser l'administration du système. WSH permet d'interprêter nativement les scripts écrits en JScript ou VBScript, mais peut supporter d'autres langages de scripts à l'aide d'extensions tierces, tels que Perl, TCL, Rexx ou Python.

WSH est apparu pour la première fois dans les systèmes Windows 98 et Windows NT SP4. Il fait désormais partie intégrante des systèmes d'exploitation Windows récents, néanmoins, il est possible de télécharger une version récente de ce moteur de script à l'adresse suivante : http://msdn.microsoft.com/scripting/.

WSH fournit un certain nombre d'objets dont la manipulation au sein d'un script permet notamment :

  • L'affichage de messages à l'écran
  • L'envoi de paramètres à des applications du système
  • Le mappage de connexions réseau
  • La connexion à des imprimantes en réseau
  • La récupération et la modification de variables d'environnement
  • La récupération et la modification de clés de la base de registres

Modèle d'objet WSH

L'environnement WSH est composé de 14 objets organisés dans arborescence dont l'objet parent est WScript :

  • WScript
    • WShArguments
      • WshNamed
      • WshUnnamed
    • WShController
      • WshRemote
        • WshRemoteError
    • WShNetwork
    • WShShell
      • WshShortCut
      • WshUrlShortCut
      • WshEnvironment
      • WshSpecialFolders
      • WshScriptExec

Voici le descriptif de chacun de ces objets :

Objet Description
Wscript
  • Récupère et définit les arguments de la ligne de commande
  • Détermine le nom du fichier de script
  • Détermine la version du système hôte
  • Crée, se connecte et se déconnecte d'objets COM
  • Récup&ergrave;re les évenements du système
  • Stoppe l'exécution d'un script
  • Envoie des informations sur le périphérique de sortie (ligne de commande, boîte de dialogue, etc.)
WshArguments Accède à l'ensemble des arguments de ligne de commande
WshNamed Accède aux arguments de ligne de commande dont le nom est précisé
WshUnnamed Accède aux arguments de ligne de commande dont le nom n'est pas précisé
WshNetwork
  • Se connecte et se déconnecte des partages réseau et des imprimantes en réseau
  • Connecte et déconnecte les lecteurs réseau
  • Accède aux informations sur les utilisateurs connectés
WshController Crée est processus de script distant grâce à la méthode CreateScript()
WshRemote
  • Permet l'aministration système à distance à travers un réseau.
  • Permet de manipuler par programmation d'autres scripts ou programmes
WshRemote Error Accède aux messages d'erreurs liées à l'exécution d'un script à distance (objet WshRemote)
WshShell
  • Permet l'exécution locale d'applications
  • Permet la manipulation de la base de registre
  • Permet la création de raccourcis
  • Permet l'accès à un répertoire du système
  • Permet la manipulation des variables d'environnement (WINDIR, PATH, ou PROMPT)
WshShortcut Crée un raccourci
WshSpecialfolders Permet d'accéder aux répertoires systèmes
WshURLShortcut Crée un raccourci vers une URL
WshEnvironment Permet la manipulation des variables d'environnement (WINDIR, PATH, ou PROMPT)
WshScriptExec Détermine le statut et les messages d'erreur d'un script exécuté avec Exec(). Permet d'accéder aux entrées-sorties standard (StdIn, StdOut, et StdErr)

A voir également :

Ce document intitulé «  Objets WSH (Windows Scripting Host)  » issu de CommentCaMarche (www.commentcamarche.net) est mis à disposition sous les termes de la licence Creative Commons. Vous pouvez copier, modifier des copies de cette page, dans les conditions fixées par la licence, tant que cette note apparaît clairement.