wscript

  • Article

S’applique à : Windows Server (toutes les versions prises en charge)

Windows Script Host fournit un environnement dans lequel les utilisateurs peuvent exécuter des scripts dans différents langages qui utilisent divers modèles objet pour effectuer des tâches.

Syntaxe

wscript [<scriptname>] [/b] [/d] [/e:<engine>] [{/h:cscript|/h:wscript}] [/i] [/job:<identifier>] [{/logo|/nologo}] [/s] [/t:<number>] [/x] [/?] [<ScriptArguments>]

Paramètres

Paramètre Description
scriptname Spécifie le chemin et le nom du fichier de script.
/b Spécifie le mode batch, qui n’affiche pas d’alertes, d’erreurs de script ni d’invites d’entrée. Le paramètre /b est l’opposé de /i.
/d Démarre le débogueur.
/e Spécifie le moteur utilisé pour exécuter le script. Ce paramètre vous permet d’exécuter des scripts qui utilisent une extension de nom de fichier personnalisée. Sans le paramètre /e, vous pouvez exécuter uniquement des scripts qui utilisent les extensions de nom de fichier inscrites. Par exemple, si vous essayez d’exécuter cette commande :
cscript test.admin
Vous recevez ce message d’erreur : Erreur d’entrée : aucun moteur de script pour l’extension de fichier .admin.
L’un des avantages d’utiliser des extensions de nom de fichier non standard est que ça empêche la double sélection accidentelle d’un script et l’exécution de quelque chose que vous ne vouliez pas exécuter.
Utiliser cette extension ne crée pas d’association permanente entre l’extension de nom de fichier .admin et VBScript. Chaque fois que vous exécutez un script qui utilise une extension de nom de fichier .admin, vous devez utiliser le paramètre /e.
/h:cscript Inscrit cscript.exe comme hôte de script par défaut pour l’exécution de scripts.
/h:wscript Inscrit wscript.exe comme hôte de script par défaut pour l’exécution de scripts. Ce comportement est la valeur par défaut quand l’option /h est omise.
/i Spécifie le mode interactif, qui affiche les alertes, les erreurs de script et les invites d’entrée.
Le paramètre /i est la valeur par défaut et l’opposé de /b.
/job:\<identifier> Exécute le travail identifié par un identificateur dans un fichier de script .wsf.
/logo Spécifie que la bannière Windows Script Host s’affiche dans la console avant l’exécution du script.
Le paramètre /logo est la valeur par défaut et l’opposé de /nologo.
/nologo Spécifie que la bannière Windows Script Host n’est pas affichée avant l’exécution du script. Le paramètre /nologo est l’opposé de /logo.
/s Enregistre les options d’invite de commandes actuelles de l’utilisateur actuel.
/t:\<number> Spécifie la durée maximale d’exécution du script (en secondes). Vous pouvez spécifier jusqu’à 32 767 secondes.
La valeur par défaut n’est pas limitée dans le temps.
/x Démarre le script dans le débogueur.
ScriptArguments Spécifie les arguments passés au script. Chaque argument de script doit être précédé d’une barre oblique (/).
/? Affiche l'aide à l'invite de commandes.

Notes

  • Pour effectuer cette tâche, vous n’avez pas besoin d’informations d’identification d’administration. Effectuez cette tâche en tant qu’utilisateur sans informations d’identification d’administration, pour des raisons de sécurité.
  • Pour ouvrir une invite de commandes, dans l’écran d’accueil, tapez cmd, puis sélectionnez invite de commandes.
  • Chaque paramètre est facultatif. Toutefois, vous ne pouvez pas spécifier d’arguments de script sans spécifier de script. Si vous ne spécifiez pas de script ou d’arguments de script, wscript.exe affiche la boîte de dialogue Paramètres Windows Script Host. Utilisez la boîte de dialogue pour définir des propriétés de script globales pour tous les scripts que wscript.exe exécute sur l’ordinateur local.
  • Le paramètre /t empêche l’exécution excessive des scripts en définissant un minuteur. Quand la durée dépasse la valeur spécifiée, wscript interrompt le moteur de script et met fin au processus.
  • Les fichiers de script Windows ont généralement une des extensions de nom de fichier suivantes : .wsf, .vbs, .js.
  • Si vous double-cliquez sur un fichier de script avec une extension qui n’a aucune association, la boîte de dialogue Ouvrir avec s’affiche. Sélectionnez wscript ou cscript, puis Toujours utiliser ce programme pour ouvrir ce type de fichier. Cela inscrit wscript.exe ou cscript.exe comme hôte de script par défaut pour les fichiers de ce type.
  • Vous pouvez définir des propriétés pour chaque script. Pour plus d’informations sur Windows Script Host, consultez Vue d’ensemble de Windows Script Host.
  • Windows Script Host peut utiliser des fichiers de script .wsf. Chaque fichier .wsf peut utiliser plusieurs moteurs de script et effectuer plusieurs travaux.