Partager via

wscript

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

L’hôte de script Windows fournit un environnement dans lequel les utilisateurs peuvent exécuter des scripts dans différents langages qui utilisent différents 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 Descriptif
scriptname Spécifie le chemin d’accès et le nom du fichier de script.
/b Spécifie le mode batch, qui n’affiche pas les alertes, les erreurs de script ou les 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 ne pouvez exécuter que des scripts qui utilisent des 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 : il n’existe aucun moteur de script pour l’extension .adminde fichier.
L’un des avantages de l’utilisation d’extensions de nom de fichier non standard est qu’elle protège contre la double sélection accidentelle d’un script et l’exécution de quelque chose que vous ne souhaitez pas réellement exécuter.
L’utilisation de cette extension ne crée pas d’association permanente entre l’extension de .admin nom de fichier et VBScript. Chaque fois que vous exécutez un script qui utilise une .admin extension de nom de fichier, vous devez utiliser le paramètre /e.
/h:cscript Inscrit cscript.exe en tant qu’hôte de script par défaut pour l’exécution de scripts.
/h:wscript Inscrit wscript.exe en tant qu’hôte de script par défaut pour l’exécution de scripts. Ce comportement est la valeur par défaut lorsque 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 l’identificateur dans un fichier de script .wsf .
/logo Spécifie que la bannière Hôte de script Windows 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 hôte de script Windows 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 pour l’utilisateur actuel.
/t:\<number> Spécifie la durée maximale pendant laquelle le script peut s’exécuter (en secondes). Vous pouvez spécifier jusqu’à 32 767 secondes.
La valeur par défaut n’est pas limite de 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.

Remarques

  • L’exécution de cette tâche ne nécessite pas que vous ayez des informations d’identification d’administration. Envisagez d’effectuer cette tâche en tant qu’utilisateur sans informations d’identification administratives comme meilleure pratique de sécurité.
  • Pour ouvrir une invite de commandes, dans l’écran de démarrage , tapez cmd, puis sélectionnez l’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 de l’hôte de script Windows . Utilisez la boîte de dialogue pour définir des propriétés de script globales pour tous les scripts qui wscript.exe s’exécutent sur l’ordinateur local.
  • Le paramètre /t empêche l’exécution excessive des scripts en définissant un minuteur. Lorsque le temps dépasse la valeur spécifiée, wscript interrompt le moteur de script et termine le processus.
  • Les fichiers de script Windows ont généralement l’une des extensions de nom de fichier suivantes : .wsf, .vbs, .js.
  • Si vous double-sélectionnez un fichier de script avec une extension sans association, la boîte de dialogue Ouvrir avec s’affiche. Sélectionnez wscript ou cscript, puis sélectionnez Toujours utiliser ce programme pour ouvrir ce type de fichier. Cela inscrit wscript.exe ou cscript.exe en tant qu’hôte de script par défaut pour les fichiers de ce type de fichier.
  • Vous pouvez définir des propriétés pour des scripts individuels. Pour plus d’informations sur l’hôte de script Windows, consultez la vue d’ensemble de l’hôte de script Windows.
  • L’hôte de script Windows peut utiliser des fichiers de script .wsf . Chaque fichier .wsf peut utiliser plusieurs moteurs de script et effectuer plusieurs travaux.