Système d'exploitation - Windows - Références de commandes et de programmes

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

Section courante

A propos

Section administrative du site

SETX