set (variable d’environnement)

Affiche, définit ou supprime cmd.exe variables d’environnement. S’il est utilisé sans paramètres, définissez les paramètres de variable d’environnement actuels.

Remarque

Cette commande nécessite des extensions de commande, qui sont activées par défaut.

La commande set peut également s’exécuter à partir de la console de récupération Windows à l’aide de différents paramètres. Pour plus d’informations, consultez Windows Recovery Environment (WinRE).

Syntaxe

set [<variable>=[<string>]]
set [/p] <variable>=[<promptString>]
set /a <variable>=<expression>

Paramètres

Paramètre	Descriptif
<variable>	Spécifie la variable d’environnement à définir ou à modifier.
<string>	Spécifie la chaîne à associer à la variable d’environnement spécifiée.
/p	Définit la valeur d’une <variable> ligne d’entrée entrée par l’utilisateur.
<promptstring>	Spécifie un message pour inviter l’utilisateur à entrer. Ce paramètre doit être utilisé avec le paramètre /p .
/un	Définit <string> sur une expression numérique évaluée.
<expression>	Spécifie une expression numérique.
/?	Affiche l'aide à l'invite de commandes.

Remarques

• Si les extensions de commande sont activées (valeur par défaut) et que vous exécutez la commande avec une valeur, elles affichent toutes les variables qui commencent par cette valeur.

• Les caractères <, , >|, &, et ^ sont des caractères d’interpréteur de commandes spéciaux, et ils doivent être précédés du caractère d’échappement (^) ou placés entre guillemets lorsqu’ils sont utilisés dans <string> (par exemple, « StringContaining&Symbol »). Si vous placez une chaîne contenant un caractère spécial entre guillemets, les guillemets sont définis comme faisant partie de la valeur de la variable d’environnement.

• Utilisez des variables d’environnement pour contrôler le comportement de certains fichiers et programmes par lots et pour contrôler la façon dont Windows et le sous-système MS-DOS apparaissent et fonctionnent. La commande set est souvent utilisée dans le fichier Autoexec.nt pour définir des variables d’environnement.

• Si vous utilisez la commande set sans paramètres, les paramètres d’environnement actuels sont affichés. Ces paramètres incluent généralement les variables d’environnement COMSPEC et PATH , qui sont utilisées pour trouver des programmes sur le disque. Deux autres variables d’environnement utilisées par Windows sont PROMPT et DIRCMD.

• Si vous spécifiez des valeurs pour <variable> et <string>, la valeur spécifiée <variable> est ajoutée à l’environnement et <string> est associée à cette variable. Si la variable existe déjà dans l’environnement, la nouvelle valeur de chaîne remplace l’ancienne valeur de chaîne.

• Si vous spécifiez uniquement une variable et un signe égal (sans <string>) pour la commande set , la <string> valeur associée à la variable est effacée (comme si la variable n’y figure pas).

• Si vous utilisez le paramètre /a , les opérateurs suivants sont pris en charge, dans l’ordre décroissant de priorité :

  Opérateur	Opération effectuée
  ( )	Regroupement
  ! ~ -	Unaire
  * / %	Arithmétique
  + -	Arithmétique
  << >>	Décalage logique
  &	AND au niveau du bit
  ^	OU exclusif au niveau du bit
  = *= /= %= += -= &= ^=	= <<= >>=
  ,	Séparateur d’expression

• Si vous utilisez des opérateurs logiques (&& ou ||) ou modulus (%), placez la chaîne d’expression entre guillemets. Toutes les chaînes non numériques de l’expression sont considérées comme des noms de variables d’environnement et leurs valeurs sont converties en nombres avant qu’elles ne soient traitées. Si vous spécifiez un nom de variable d’environnement qui n’est pas défini dans l’environnement actuel, la valeur zéro est allouée, ce qui vous permet d’effectuer une arithmétique avec des valeurs de variable d’environnement sans utiliser le % pour récupérer une valeur.

• Si vous exécutez le jeu /a à partir de la ligne de commande en dehors d’un script de commande, il affiche la valeur finale de l’expression.

• Les valeurs numériques sont des nombres décimaux, sauf si préfixés par 0× pour les nombres hexadécimaux ou 0 pour les nombres octal. Par conséquent, 0×12 est identique à 18, ce qui est le même que 022.

• La prise en charge de l’extension des variables d’environnement retardée est désactivée par défaut, mais vous pouvez l’activer ou la désactiver à l’aide de cmd /v.

• Lors de la création de fichiers batch, vous pouvez utiliser la définition pour créer des variables, puis les utiliser de la même façon que les variables numérotées %0 via %9. Vous pouvez également utiliser les variables %0 via %9 comme entrée pour le jeu.

• Si vous appelez une valeur de variable à partir d’un fichier batch, placez la valeur avec des signes de pourcentage (%). Par exemple, si votre programme batch crée une variable d’environnement nommée BAUD, vous pouvez utiliser la chaîne associée à BAUD comme paramètre remplaçable en tapant %baud% à l’invite de commandes.

Exemples

Pour définir la valeur TEST^1 pour la variable d’environnement nommée testVar, tapez :

set testVar=TEST^^1

La commande set affecte tout ce qui suit le signe égal (=) à la valeur de la variable. Par conséquent, si vous tapez set testVar=TEST^1, vous obtiendrez le résultat suivant. testVar=TEST1

Pour définir la valeur TEST&1 pour la variable testVard’environnement, tapez :

set testVar=TEST^&1

Pour définir une variable d’environnement nommée include , la chaîne c :\directory est associée, tapez :

set include=c:\directory

Vous pouvez ensuite utiliser la chaîne c :\directory dans les fichiers batch en englobant le nom avec des signes de pourcentage (%). Par exemple, vous pouvez utiliser dir %include% dans un fichier de commandes pour afficher le contenu du répertoire associé à la variable d’environnement include . Une fois cette commande traitée, la chaîne c :\directory remplace %include%.

Pour utiliser la commande set dans un programme batch pour ajouter un nouveau répertoire à la variable d’environnement de chemin d’accès , tapez :

@echo off
rem ADDPATH.BAT adds a new directory
rem to the path environment variable.
set path=%1;%path%
set

Pour afficher la liste de toutes les variables d’environnement qui commencent par la lettre p, tapez :

set p

Pour afficher la liste de toutes les variables d’environnement sur l’appareil actuel, tapez :

set

Liens connexes

• Clé de syntaxe de ligne de commande