Langage: MS-DOS

A B C D E F G H I L M N O P Q R S T U V W X

Echo

Active ou désactive la fonctionnalité d'écho des commandes ou affiche un message. Utilisée sans paramètre, la commande echo affiche le paramètre d'écho actuel.

Syntaxe

echo [{on|off}] [message]

echo [voici le texte qui sera écrit dans texte.txt] >> C:\texte.txt

Paramètres

{on|off}
Indique si l'écho des commandes doit être activé ou désactivé.
message
Spécifie le texte que vous voulez afficher à l'écran.
/?
Affiche l'aide dans l'invite de commandes.

Remarques

  • La commande echo message s'avère utile quand l'écho est désactivé. Pour faire apparaître un message de plusieurs lignes de long sans afficher d'autres commandes, vous pouvez inclure plusieurs commandes echo message à la suite de la commande echo off dans votre programme de commandes.
  • Si vous utilisez echo off, l'invite de commandes n'apparaît pas à l'écran. Pour afficher l'invite de commandes, tapez echo on.
  • Pour éviter l'écho d'une ligne, insérez un signe (@) devant une commande dans un programme de commandes.
  • Pour faire un écho d'une ligne blanche à l'écran, tapez :

    echo.

  • Pour afficher un signe “ | ” ou un caractère de redirection (< ou >) quand vous utilisez echo, faites-le précéder d'un caret (par exemple, ^>, ^< ou ^| ). Si vous devez utiliser le caret proprement dit (^), tapez-le deux fois (^^).

Exemples

L'exemple suivant illustre un programme de commandes qui inclut un message de trois lignes précédées et suivies d'une ligne blanche :

echo off
echo.
echo This batch program
echo formats and checks
echo new disks
echo report ok, by >>c:\rapport.rtf

Pour désactiver echo et ne pas renvoyer en écho la commande echo elle-même, faites précéder celle-ci d'un signe @, comme suit :

@echo off

Vous pouvez utiliser les commandes if et echo sur la même ligne de commande. Exemple :

if exist *.rpt echo Le rapport nous est parvenu.

Endlocal

Met fin à la localisation des modifications d'environnement dans un fichier de commandes, en rétablissant les valeurs des variables d'environnement avant la commande concordante setlocal.

Syntaxe

endlocal

Paramètres

/?
Affiche l'aide dans l'invite de commandes.

Remarques

  • Vous devez utiliser endlocal dans un script ou un fichier de commandes. Si vous utilisez endlocal en dehors d'un script ou un fichier de commandes, il est sans effet.
  • Il existe une commande endlocal implicite à la fin d'un fichier de commandes.
  • Si les extensions de commande sont activées (ce qui est le cas par défaut), la commande endlocal rétablit l'état des extensions de commande (c'est-à-dire activé ou désactivé) en vigueur avant l'exécution de la commande setlocal correspondante. Pour plus d'informations sur l'activation et la désactivation d'extensions de commandes, consultez cmd dans Rubriques connexes.

Exemples

Vous pouvez localiser des variables d'environnement dans un fichier de commandes. Exemple :

@echo off

rem Ce programme lance le programme de commandes superapp sur le réseau,

rem dirige la sortie d'un fichier et affiche le fichier

rem dans le Bloc-notes.

setlocal

path=g:\programs\superapp;%path%

call superapp>c:\superapp.out

endlocal

start notepad c:\superapp.out

Eventcreate

Permet à un administrateur de créer un événement personnalisé dans un journal d'événements spécifié.

Syntaxe

eventcreate [/s Ordinateur [/u Domaine\Utilisateur [/p MotDePasse]] {[/l {APPLICATION|SYSTEM}]|[/so NomSrc]} /t {ERROR|WARNING|INFORMATION|SUCCESSAUDIT|FAILUREAUDIT} /id IDÉvénement /d Description

Paramètres

/s Ordinateur
Spécifie le nom ou l'adresse IP d'un ordinateur distant (n'utilisez pas de barres obliques inverses). Il s'agit par défaut de l'ordinateur local.
/u Domaine\Utilisateur
Exécute la commande avec les autorisations de compte de l'utilisateur spécifié par Utilisateur ou Domaine\Utilisateur. Il s'agit par défaut des autorisations de l'utilisateur actuellement connecté sur l'ordinateur où est émise la commande.
/p MotDePasse
Spécifie le mot de passe du compte d'utilisateur spécifié par le paramètre /u.
/l {APPLICATION|SYSTEM}
Spécifie le nom du journal des événements où l'événement sera créé. Les noms de journaux valides sont APPLICATION et SYSTEM.
/so NomSrc
Spécifie la source à utiliser pour l'événement. Une source valide peut être n'importe quelle chaîne et doit représenter l'application ou le composant qui génère l'événement.
/t {ERROR|WARNING|INFORMATION|SUCCESSAUDIT|FAILUREAUDIT}
Spécifie le type d'événement à créer. Les types valides sont ERROR, WARNING, INFORMATION, SUCCESSAUDIT et FAILUREAUDIT.
/id IDÉvénement
Spécifie l'ID d'événement de l'événement. Un ID valide peut être n'importe quel nombre entre 1 et 65535.
/d Description
Spécifie la description à utiliser pour l'événement nouvellement créé.
/?
Affiche l'aide dans l'invite de commandes.

Remarques

  • Les événements personnalisés ne peuvent pas être écrits dans le journal de sécurité.

Exemples

Les exemples suivants décrivent l'utilisation de la commande eventcreate :

eventcreate /t error /id 100 /l application /d "Créer un événement dans le journal

d'application"


eventcreate /t information /id 1000 /so winmgmt /d "Créer un événement dans la source

WinMgmt"


eventcreate /t error /id 2001 /so winword /l application /d "nouveau Winword src dans le

journal d'application"


eventcreate /s server /t error /id 100 /l application /d "Machine distante sans informations

d'identification d'utilisateur"


eventcreate /s server /u user /p password /id 100 /t error /l application /d "Machine

distante avec informations d'identification d'utilisateur"


eventcreate /s server1 /s server2 /u user /p password /id 100 /t error /so winmgmt /d

"Création d'événements sur plusieurs machine distantes"


eventcreate /s server /u user /id 100 /t warning /so winmgmt /d "Machine distante avec

informations d'identification d'utilisateur partielles"

Eventquery.vbs

Répertorie les événements et les propriétés d'événements dans un ou plusieurs journaux.

Syntaxe

eventquery[.vbs] [/s Ordinateur [/u Domaine\Utilisateur [/p MotDePasse]]] [/fi NomFiltre] [/fo {TABLE|LIST|CSV}] [/r PlageÉvénement [/nh] [/v] [/l [APPLICATION] [SYSTEM] [SECURITY] ["DNS server"]

[JournalDéfiniParUtilisateur] [NomJournalRépertoire] [*] ]

Paramètres

/s Ordinateur
Spécifie le nom ou l'adresse IP d'un ordinateur distant (n'utilisez pas de barres obliques inverses). Il s'agit par défaut de l'ordinateur local.
/u Domaine\Utilisateur
Exécute le script avec les autorisations de compte de l'utilisateur spécifié par Utilisateur ou Domaine\Utilisateur. Il s'agit par défaut des autorisations de l'utilisateur actuellement connecté sur l'ordinateur où est émise la commande.
/p MotDePasse
Spécifie le mot de passe du compte d'utilisateur spécifié par le paramètre /u.
/fi NomFiltre
Spécifie les types d'événements à inclure ou à exclure de la requête. Pour trouver des événements ayant une de ces valeurs, Type et ID peuvent être utilisés ensemble dans une seule déclaration en utilisant l'opérateur or. Les exemples suivants sont des noms de filtres valides, des opérateurs et des valeurs.
Nom Opérateur Valeur
Datetime eq, ne, ge, le, gt, lt mm/jj/aa(aaaa), hh:mm:ssAM(/PM)
Tapez eq, ne {ERROR|INFORMATION|WARNING|

SUCCESSAUDIT|FAILUREAUDIT}
ID eq, ne, ge, le, gt, lt N'importe quel entier positif valide.
Utilisateur eq, ne Toute chaîne valide.
Ordinateur eq, ne Toute chaîne valide.
Source eq, ne Toute chaîne valide.
Catégorie eq, ne Toute chaîne valide
/fo {TABLE|LIST|CSV}
Spécifie le format à utiliser pour la sortie. Les valeurs valides sont table, list et csv.
/r PlageÉvénement
Spécifie la plage d'événements à répertorier.
Valeur Description
O Répertorie les N événements les plus récents.
-N Répertorie les N événements les plus anciens.
N1-N2 Répertorie les événements de N1 à N2.
/nh
Supprime les en-têtes de colonnes dans la sortie. Valide uniquement pour les formats table et csv.
/v
Spécifie l'affichage des commentaires sur les événements dans la sortie.
/l [APPLICATION] [SYSTEM] [SECURITY] ["DNS server"] [JournalDéfiniParUtilisateur] [NomJournalRépertoire] [*] ]
Spécifie le ou les journaux à surveiller. Les valeurs valides sont Application, System, Security, "DNS server", un journal défini par l'utilisateur et un journal de répertoire. "DNS server" peut être utilisé uniquement si le service DNS est exécuté sur l'ordinateur spécifié par le paramètre /s. Pour spécifier plusieurs journaux à surveiller, utilisez à nouveau le paramètre /l. Le caractère générique (*) peut être utilisé et est la valeur par défaut.
/?
Affiche l'aide à l'invite de commandes.

Remarques

  • Pour exécuter ce script, vous devez exécuter CScript. Si vous n'avez pas encore défini l'hôte de script par défaut comme étant CScript, tapez :

    cscript //h:cscript //s //nologo

Exemples

Les exemples suivants décrivent l'utilisation de la commande eventquery :

eventquery /l system
eventquery /l mylog
eventquery /l application /l system
eventquery /s srvmain /u maindom\hiropln /p p@ssW23 /v /l *
eventquery /r 10 /l application /nh
eventquery /r -10 /fo LIST /l security
eventquery /r 5-10 /l "DNS server"
eventquery /fi "Type eq Error" /l application
eventquery /fi "Datetime eq 06/25/00,03:15:00AM/06/25/00,03:15:00PM" /l application
eventquery /fi "Datetime gt 08/03/00,06:20:00PM" /fi "id gt 700" /fi "Type eq warning"

/l system eventquery /fi "ID eq 1000 OR ID ge 4500" eventquery /fi "Type eq error OR Type eq INFORMATION" eventquery /fi "ID eq 250 OR Type eq ERROR"

Eventtriggers

Affiche et configure les déclencheurs d'événements sur les machines locales ou distantes.

Pour afficher la syntaxe d'une commande, sélectionnez-la :

eventtriggers create

eventtriggers delete

Supprime un déclencheur d'événement d'un système sur la base de son ID de déclencheur d'événement.

Syntaxe

eventtriggers[.exe] /delete [/s Ordinateur [/u Domaine\Utilisateur [/p MotDePasse]]] /tid {ID|*}

Paramètres

/s Ordinateur
Spécifie le nom ou l'adresse IP d'un ordinateur distant (n'utilisez pas de barres obliques inverses). Il s'agit par défaut de l'ordinateur local.
/u Domaine\Utilisateur
Exécute la commande avec les autorisations de compte de l'utilisateur spécifié par Utilisateur ou Domaine\Utilisateur. Il s'agit par défaut des autorisations de l'utilisateur actuellement connecté sur l'ordinateur où est émise la commande.
/p MotDePasse
Spécifie le mot de passe du compte d'utilisateur spécifié par le paramètre /u.
/tid {ID|*}
Spécifie le ou les déclencheurs d'événements à supprimer par « ID de déclencheur d'événement ». Vous pouvez utiliser le caractère générique (*).
/?
Affiche l'aide à l'invite de commandes.

Exemples

Les exemples suivants décrivent l'utilisation de la commande eventtriggers/delete :

eventtriggers /delete /tid 1 /tid 2 /tid 4 /tid 6
eventtriggers /delete /s srvmain /u maindom\hiropln /p p@ssW23 /tid *
eventtriggers /delete /s srvmain /u maindom\hiropln /p p@ssW23 /tid 1

eventtriggers query

Interroge et affiche les propriétés et les paramètres des déclencheurs d'événements d'un système.

Syntaxe

eventtriggers[.exe] /query [/s Ordinateur [/u Domaine\Utilisateur [/p MotDePasse]]] [/fo {TABLE|LIST|CSV}] [/nh] [/v]

Paramètres

/s Ordinateur
Spécifie le nom ou l'adresse IP d'un ordinateur distant (n'utilisez pas de barres obliques inverses). Il s'agit par défaut de l'ordinateur local.
/u Domaine\Utilisateur
Exécute la commande avec les autorisations de compte de l'utilisateur spécifié par Utilisateur ou Domaine\Utilisateur. Il s'agit par défaut des autorisations de l'utilisateur actuellement connecté sur l'ordinateur où est émise la commande.
/p MotDePasse
Spécifie le mot de passe du compte d'utilisateur spécifié par le paramètre /u.
/fo {TABLE|LIST|CSV}
Spécifie le format à utiliser pour la sortie de la requête. Les valeurs valides sont TABLE, LIST et CSV. Le format de sortie par défaut est TABLE.
/nh
Supprime l'en-tête de colonne dans la sortie. Valide lorsque le paramètre /fo est TABLE ou CSV.
/v
Spécifie l'affichage d'informations détaillées dans la sortie.
/?
Affiche l'aide à l'invite de commandes.

Exemples

Les exemples suivants décrivent l'utilisation de la commande eventtriggers/query :

eventtriggers /query
eventtriggers /query /s srvmain
eventtriggers /query /s srvmain /u maindom\hiropln /p p@ssW23 /fo list

Remarques

  • Spécifié sans opération, eventtriggers renvoie une liste de déclencheurs d'événements. Pour afficher une liste de déclencheurs d'événements, tapez :

    eventtriggers

    Une sortie similaire à ce qui suit apparaît : 

    

Trigger ID Event Trigger Name         Task

========== ======================== ==============================

         1 Disk Cleanup             c:\windows\system32\cleanmgr.exe
  • En cas d'échec d'exécution d'un événement, eventtriggers crée un fichier journal appelé TriggerConsumer.log dans le répertoire \windows\system32\wbem\logs qui contient un message indiquant que l'événement ne s'est pas déclenché.

Evntcmd

Configure la traduction des événements en interruptions, en destinations d'interruptions, ou les deux, en fonction des informations contenues dans un fichier de configuration.

Syntaxe

evntcmd [/s NomOrdinateur] [/v NiveauDétail] [/n] NomFichier

Paramètres

/s NomOrdinateur
Spécifie, par nom, l'ordinateur sur lequel vous voulez configurer la traduction des événements en interruptions, en destinations d'interruptions, ou les deux. Si vous ne spécifiez pas d'ordinateur, la configuration se produit sur l'ordinateur local.
/v NiveauDétail
Spécifie quels types de messages d'état apparaissent lorsque les interruptions et les destinations d'interruptions sont configurées. Ce paramètre doit être un entier compris entre 0 et 10. Si vous spécifiez 10, tous les types de messages apparaissent, y compris les messages de traçage et les avertissements relatifs à la réussite ou non de la configuration des interruptions. Si vous spécifiez 0, aucun message n'apparaît.
/n
Spécifie que le service SNMP ne doit pas être redémarré si cet ordinateur reçoit des modifications de configuration des interruptions.
NomFichier
Spécifie, par nom, le fichier de configuration qui contient les informations à propos de la traduction des événements en interruptions et en destinations des interruptions que vous voulez configurer.
/?
Affiche l'aide dans l'invite de commandes.

Remarques

  • Si vous voulez configurer les interruptions, mais pas les destinations d'interruptions, vous pouvez créer un fichier de configuration valide à l'aide de l'utilitaire graphique Convertisseur d’événement en interruption. Si le service SNMP est installé, vous pouvez démarrer le Convertisseur d’événement en interruption en tapant evntwin dans une invite de commande. Lorsque vous avez défini les interruptions voulues, cliquez sur Exporter pour créer un fichier approprié pour evntcmd. Vous pouvez utiliser le Convertisseur d’événement en interruption pour créer facilement un fichier de configuration que vous pourrez utiliser avec evntcmd à l'invite de commande pour configurer rapidement des interruptions sur plusieurs ordinateurs.
  • La syntaxe de configuration d'une interruption est la suivante :

    #pragma ADD FichierJournalÉvénements SourceÉvénement IDÉvénement [Compte [Période]]

    • Le texte #pragma doit figurer au début de chaque entrée du fichier.
    • Le paramètre ADD spécifie que vous voulez ajouter une configuration d'événement en interruption.
    • Les paramètres FichierJournalÉvénements, SourceÉvénement et IDÉvénement sont requis. Le paramètre FichierJournalÉvénements spécifie le fichier dans lequel l'événement est enregistré. Le paramètre SourceÉvénement spécifie l'application qui génère l'événement. Le paramètre IDÉvénement spécifie le numéro unique qui identifie chaque événement. Pour trouver les valeurs qui correspondent aux événements spécifiques, démarrez le Convertisseur d’événement en interruption en tapant evntwin à une invite de commande. Cliquez sur Personnalisé, puis sur Modifier. Sous Sources d'événements, parcourez les dossiers jusqu'à ce que vous localisiez l'événement que vous voulez configurer, cliquez dessus, puis cliquez sur Ajouter. Les informations sur la source de l'événement, le fichier journal des événements et l'identificateur d'événement apparaissent respectivement sous Source, Journal et ID spécifique de l'interruption.
    • Le paramètre Compte est facultatif, et il spécifie combien de fois l'événement doit se produire avant l'envoi d'un message d'interruption. Si vous n'utilisez pas le paramètre Compte, le message d'interruption est envoyé à la première manifestation de l'événement.
    • Le paramètre Période est facultatif, mais il exige l'utilisation du paramètre Compte. Le paramètre Période spécifie une durée (en secondes) au cours de laquelle l'événement doit se produire le nombre de fois spécifié par le paramètre Compte avant l'envoi d'un message d'interruption. Si vous n'utilisez pas le paramètre Période, un message d'interruption est envoyé lorsque l'événement s'est produit le nombre de fois spécifié par le paramètre Compte, quelle que soit la durée sépara nt deux occurrences.
  • La syntaxe de suppression d'une interruption est la suivante :

    #pragma DELETE FichierJournalÉvénements SourceÉvénement IDÉvénement

    • Le texte #pragma doit figurer au début de chaque entrée du fichier.
    • Le paramètre DELETE spécifie que vous voulez supprimer une configuration d'événement en interruption.
    • Les paramètres FichierJournalÉvénements, SourceÉvénement et IDÉvénement sont requis. Le paramètre FichierJournalÉvénements spécifie le journal dans lequel l'événement est enregistré. Le paramètre SourceÉvénement spécifie l'application qui génère l'événement. Le paramètre IDÉvénement spécifie le numéro unique qui identifie chaque événement.
  • La syntaxe de configuration d'une destination d'interruption est la suivante :

    #pragma ADD_TRAP_DEST NomCommunauté IDHôte

    • Le texte #pragma doit figurer au début de chaque entrée du fichier.
    • Le paramètre ADD_TRAP_DEST spécifie que vous voulez que des messages d'interruption soient envoyés à un hôte spécifique au sein d'une communauté.
    • Le paramètre NomCommunauté spécifie, par nom, la communauté dans laquelle les messages d'interruption sont envoyés.
    • Le paramètre IDHôte spécifie, par nom ou adresse IP, l'hôte auquel vous voulez que des messages d'interruption soient envoyés.
  • La syntaxe de suppression d'une destination d'interruption est la suivante :

    #pragma DELETE_TRAP_DEST NomCommunauté IDHôte

    • Le texte #pragma doit figurer au début de chaque entrée du fichier.
    • Le paramètre DELETE_TRAP_DEST spécifie que vous ne voulez pas que des messages d'interruption soient envoyés à un hôte spécifique au sein d'une communauté.
    • Le paramètre NomCommunauté spécifie, par nom, la communauté dans laquelle les messages d'interruption sont envoyés.
    • Le paramètre IDHôte spécifie, par nom ou adresse IP, l'hôte auquel vous ne voulez pas que des messages d'interruption soient envoyés.

Exemples

Les exemples suivants illustrent les entrées dans le fichier de configuration pour la commande evntcmd. Elles ne sont pas destinées à être tapées à une invite de commande.

Pour envoyer un message d'interruption si le service Journal des événements est redémarré, tapez :

#pragma ADD System "Eventlog" 2147489653

Pour envoyer un message d'interruption si le service Journal des événements est redémarré deux fois en trois minutes, tapez :

#pragma ADD System "Eventlog" 2147489653 2 180

Pour cesser d'envoyer un message d'interruption dès que le service Journal des événements est redémarré, tapez :

#pragma DELETE System "Eventlog" 2147489653

Pour envoyer des messages d'interruption dans la communauté nommée Public vers l'hôte dont l'adresse IP est 192.168.100.100, tapez :

#pragma ADD_TRAP_DEST public 192.168.100.100

Pour envoyer des messages d'interruption dans la communauté nommée Private vers l'hôte nommé Host1, tapez :

#pragma ADD_TRAP_DEST private Host1

Pour cesser d'envoyer des messages d'interruption dans la communauté Private à l'ordinateur sur lequel vous configurez les destinations d'interruptions, tapez :

#pragma DELETE_TRAP_DEST private localhost

Exit

Quitte le script de commandes ou le programme Cmd.exe (c'est-à-dire l'interpréteur de commande) en cours et retourne au programme qui a démarré Cmd.exe ou au Gestionnaire de programmes.

Syntaxe

exit [/b] [CodeSortie]

Paramètres

/b
Quitte le script de commandes en cours.
CodeSortie
Spécifie une valeur numérique.
/?
Affiche l'aide dans l'invite de commandes.

Remarques

  • Si vous utilisez /b en dehors d'un script de commande, vous quittez Cmd.exe.
  • Si vous utilisez /b, Cmd.exe définit ERRORLEVEL comme étant le CodeSortie spécifié. Si vous quittez Cmd.exe, Cmd.exe définit le code de sortie du processus à l'aide du CodeSortie spécifié.

Expand

Décompresse un ou plusieurs fichiers compressés. Cette commande est utilisée pour récupérer des fichiers compressés de disquettes de distribution.

Syntaxe

expand [-r] Source [Destination]

expand -d source.cab [-f:fichiers]

expand source.cab -f:fichiers Destination

Paramètres

-r
Renomme les fichiers décompressés.
-d
Affiche la liste des fichiers à l'emplacement source. Ce paramètre ne décompresse pas ou n'extrait pas les fichiers.
-f:fichiers
Spécifie les fichiers d'un fichier cabinet (.cab) à décompresser. Vous pouvez utiliser des caractères génériques (* et ?).
Source
Spécifie les fichiers à décompresser. Source peut se composer d'une lettre de lecteur et du signe deux-points, d'un nom de répertoire, d'un nom de fichier ou d'une combinaison de ces éléments. Vous pouvez utiliser des caractères génériques (* et ?).
Destination
Spécifie l'emplacement où les fichiers doivent être décompressés. Si Source correspond à plusieurs fichiers et si -r n'est pas spécifié, la Destination doit être un répertoire. Destination peut se composer d'une lettre de lecteur et d'un deux-points, d'un nom de répertoire, d'un nom de fichier ou d'une combinaison de ces éléments.
/?
Affiche l'aide dans l'invite de commandes.

Remarques

  • Utilisation expand dans la console de récupération

    La commande expand, avec d'autres paramètres, est disponible à partir de la console de récupération.