SETX |
Fixe le X |
---|---|
Windows | Externe |
Syntaxe
SETX [/s Computer [Credentials]] Variable Value [/m] |
SETX [/s Computer [Credentials]] [Variable] /k RegistryPath [/m] |
SETX [/s Computer [Credentials]] /f FileName {[Variable] {/a L,T | /r oL,oT "SearchString"} [/m] | /x} [/d Delimiters] |
Paramètres
Nom | Description |
---|---|
/s Computer | Ce paramètre permet d'indiquer le nom ou l'adresse IP d'un ordinateur à distance. N'utilisez pas de barres obliques inverses. Par défaut, l'ordinateur local est utilisé. |
Credentials | Ce paramètre permet d'indiquer le nom d'utilisateur et le mot de passe utilisés pour se connecter à l'ordinateur : /u [Domain\]UserName [/p [Password]]] |
/u [Domain\]UserName | Ce paramètre permet d'exécuter le script avec les informations d'identification du compte d'utilisateur spécifié. La valeur par défaut correspond aux autorisations système. |
/p [Password] | Ce paramètre permet d'indiquer le mot de passe du compte d'utilisateur spécifié dans le paramètre /u. |
Variable | Ce paramètre permet d'indiquer le nom de la variable d'environnement que vous souhaitez définir. |
Value | Ce paramètre permet d'indiquer la valeur à laquelle vous souhaitez définir la variable d'environnement. |
/k RegistryPath | Ce paramètre permet de définir la variable en fonction des informations d'une clef de registre. |
/f FileName | Ce paramètre permet d'indiquer le fichier que vous souhaitez lire. |
/a L,T | Ce paramètre permet d'indiquer le jeton T de la ligne L dans le fichier. Les coordonnées L (ligne) et T (jeton) sont numérotées à partir de 0. |
/r oL,oT "SearchString" | Ce paramètre permet de rechercher dans le fichier un jeton correspondant à SearchString, insensible à la casse. Les coordonnées décalées oL (ligne) et oT (jeton) sont numérotées à partir de 0. Les nombres négatifs pour oL & oT compteront respectivement vers le haut et vers la gauche. Si le jeton n'est pas trouvé, %errorlevel% sera défini sur 1. |
/m | Ce paramètre permet d'indiquer qu'il faut définir la variable dans l'environnement système HKLM. La valeur par défaut est l'environnement local HKCU. |
/x | Ce paramètre permet d'indiquer qu'il faut afficher le fichier avec les coordonnées de chaque jeton. |
/d Delimiters | Ce paramètre permet d'indiquer les délimiteurs tels que "," ou "\" à utiliser en plus des quatre délimiteurs intégrés : espace, tabulation (TAB), retour de chariot (CR) et saut de ligne (LINEFEED). Les délimiteurs valides incluent tout caractère ASCII. Le nombre maximum de délimiteurs est de 15, y compris les délimiteurs intégrés. |
Description
Cette commande permet de fixer ou de demander le contenu des variables d'environnement de manière permanente dans le système d'exploitation ou de fixer une variable dans la base de registres de Windows.
Remarques
- Étant donné que la commande SETX écrit des variables dans l'environnement maître dans le registre, les modifications ne prendront effet qu'à l'ouverture d'une nouvelle fenêtre de commande, elles n'affectent pas la session des interpréteurs de commande CMD ou PowerShell en cours.
- Les variables de la machine sont entreposées sur la machine et ne suivront pas le profil itinérant d'un utilisateur. La définition d'une variable machine (/m) nécessite des droits d'administrateur.
- Les variables utilisateur sont entreposées dans le profil utilisateur et suivront le profil itinérant des utilisateurs.
- Si des variables de même nom sont entreposées en tant que variables d'environnement utilisateur et machine, la variable utilisateur aura la priorité. Si une variable de session est créée, elle prévaudra sur toute variable d'environnement utilisateur et/ou machine du même nom.
- L'interpréteur de commande CMD ne lira pas une variable d'environnement si elle contient plus de 8 191 caractères. Le prompt de commandes ignorera également toutes les variables d'environnement héritées d'un processus parent si elles dépassent 8 191 caractères.
- La commande SETX peut être utilisé pour définir des variables d'environnement à partir de l'une des trois sources (modes): String Value Mode, Registry Mode ou File Mode.
Exemple
L'exemple suivant permet de fixer le prompt par défaut de façon permanente :
SETX PROMPT $P$G |
Variante
Station de travail | Serveur | Clone | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
Windows 98 | Windows XP | Windows Vista | Windows 7 | Windows 8 | Windows 10 | Windows NT Server | Windows 2000 Server | Windows Server 2003 | Windows Server 2008 | ReactOS |
Dernière mise à jour : Samedi, le 15 février 2020