Partager via

SETx

Crée ou modifie des variables d’environnement dans l’environnement utilisateur ou système, sans nécessiter de programmation ou de script. La commande Setx récupère également les valeurs des clés de Registre et les écrit dans des fichiers texte.

Remarque

Cette commande fournit la seule méthode de ligne de commande ou de programmation pour définir directement et définitivement les valeurs d’environnement système. Les variables d’environnement système sont configurables manuellement via Panneau de configuration ou via un éditeur de Registre. Le définir commande, qui est interne à l’interpréteur de commandes (Cmd.exe), définit uniquement les variables d’environnement utilisateur pour la fenêtre de console active.

Syntaxe

setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]] <variable> <value> [/m]
setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]] <variable>] /k <path> [/m]
setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]] /f <filename> {[<variable>] {/a <X>,<Y> | /r <X>,<Y> <String>} [/m] | /x} [/d <delimiters>]

Paramètres

Paramètre Descriptif
/s <computer> Spécifie le nom ou l’adresse IP d’un ordinateur distant. N’utilisez pas de barres obliques inverses. La valeur par défaut est le nom de l’ordinateur local.
/u [<domain>\]<user name> Exécute le script avec les informations d’identification du compte d’utilisateur spécifié. La valeur par défaut est les autorisations système.
/p [<password>] Spécifie le mot de passe du compte d’utilisateur spécifié dans le paramètre /u.
<variable> Spécifie le nom de la variable d’environnement que vous souhaitez définir.
<value> Spécifie la valeur à laquelle vous souhaitez définir la variable d’environnement.
/k <path> Spécifie que la variable est définie en fonction des informations d’une clé de Registre. Le chemin d’accès utilise la syntaxe suivante : \\<HIVE>\<KEY>\...\<Value>. Par exemple, vous pouvez spécifier le chemin suivant : HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName
/f <filename> Spécifie le fichier que vous souhaitez utiliser.
/un <X>,<Y> Spécifie les coordonnées absolues et le décalage en tant que paramètres de recherche.
/r <X>,<Y> <String> Spécifie les coordonnées relatives et le décalage de chaîne en tant que paramètres de recherche.
/m Spécifie de définir la variable dans l’environnement système. Le paramètre par défaut est l’environnement local.
/x Affiche les coordonnées de fichier, en ignorant les options de ligne de commande /a, /ret /d.
/d <delimiters> Spécifie des délimiteurs tels que , ou \ à utiliser en plus des quatre délimiteurs intégrés ( ESPACE, TAB, ENTRÉE et LINEFEED). Les délimiteurs valides incluent n’importe quel caractère ASCII. Le nombre maximal de délimiteurs est de 15, y compris les délimiteurs intégrés.
/? Affiche l’aide à l’invite de commandes.

Remarques

  • Cette commande est similaire à l’utilitaire UNIX SETENV.

  • Vous pouvez utiliser cette commande pour définir des valeurs pour les variables d’environnement utilisateur et système à partir de l’une des trois sources (modes) : mode ligne de commande, mode Registre ou mode fichier.

  • Cette commande écrit des variables dans l’environnement maître dans le Registre. Les variables définies avec variables setx sont disponibles uniquement dans les fenêtres de commande futures, et non dans la fenêtre de commande actuelle.

  • HKEY_CURRENT_USER et HKEY_LOCAL_MACHINE sont les seules ruches prises en charge. REG_DWORD, REG_EXPAND_SZ, REG_SZ et REG_MULTI_SZ sont les types de données RegKey valides.

  • Si vous accédez à REG_MULTI_SZ valeurs dans le Registre, seul le premier élément est extrait et utilisé.

  • Vous ne pouvez pas utiliser cette commande pour supprimer les valeurs ajoutées aux environnements locaux ou système. Vous pouvez utiliser cette commande avec un nom de variable et aucune valeur pour supprimer une valeur correspondante de l’environnement local.

  • REG_DWORD valeurs de Registre sont extraites et utilisées en mode hexadécimal.

  • Le mode Fichier prend uniquement en charge l’analyse des fichiers texte de retour chariot et de flux de ligne (CRLF).

  • L’exécution de cette commande sur une variable existante supprime toutes les références de variables et utilise des valeurs développées.

    Par exemple, si la variable %PATH% a une référence à %JAVADIR%et %PATH% est manipulée à l’aide de setx , %JAVADIR% est développée et sa valeur est affectée directement à la variable cible %PATH%. Cela signifie que les futures mises à jour de %JAVADIR% ne seront pas reflétées dans la variable %PATH%.

  • N’oubliez pas qu’il existe une limite de 1 024 caractères lors de l’affectation du contenu à une variable à l’aide de setx.

    Cela signifie que le contenu est rogné si vous dépassez 1024 caractères et que le texte rogné est ce qui est appliqué à la variable cible. Si ce texte rogné est appliqué à une variable existante, il peut entraîner la perte de données précédemment détenues par la variable cible.

Exemples

Pour définir la variable d’environnement machine dans l’environnement local sur la valeur Brand1, tapez :

setx MACHINE Brand1

Pour définir la variable d’environnement MACHINE dans l’environnement système sur la valeur 'ordinateur Brand1, tapez :

setx MACHINE Brand1 Computer /m

Pour définir la variable d’environnement MYPATH dans l’environnement local pour utiliser le chemin de recherche défini dans la variable d’environnement PATH, tapez :

setx MYPATH %PATH%

Pour définir la variable d’environnement MYPATH dans l’environnement local pour utiliser le chemin de recherche défini dans la variable d’environnement PATH après avoir remplacé ~ par %, tapez :

setx MYPATH ~PATH~

Pour définir la variable d’environnement machine dans l’environnement local sur Brand1 sur un ordinateur distant nommé ordinateur1, tapez :

setx /s computer1 /u maindom\hiropln /p p@ssW23 MACHINE Brand1

Pour définir la variable d’environnement MYPATH dans l’environnement local pour utiliser le chemin de recherche défini dans la variable d’environnement PATH sur un ordinateur distant nommé ordinateur1, tapez :

setx /s computer1 /u maindom\hiropln /p p@ssW23 MYPATH %PATH%

Pour définir la variable d’environnement TZONE dans l’environnement local sur la valeur trouvée dans la clé de Registre HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName, tapez :

setx TZONE /k HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName

Pour définir la variable d’environnement TZONE dans l’environnement local d’un ordinateur distant nommé ordinateur1 à la valeur trouvée dans la clé de Registre HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName, tapez :

setx /s computer1 /u maindom\hiropln /p p@ssW23 TZONE /k HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName

Pour définir la variable d’environnement BUILD dans l’environnement système sur la valeur trouvée dans la clé de Registre HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber, tapez :

setx BUILD /k HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber /m

Pour définir la variable d’environnement BUILD dans l’environnement système d’un ordinateur distant nommé Computer1 sur la valeur trouvée dans la clé de Registre HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber, tapez :

setx /s computer1 /u maindom\hiropln /p p@ssW23  BUILD /k HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\CurrentBuildNumber /m

Pour afficher le contenu d’un fichier nommé Ipconfig.out, ainsi que les coordonnées correspondantes du contenu, tapez :

setx /f ipconfig.out /x

Pour définir la variable d’environnement IPADDR dans l’environnement local sur la valeur trouvée au niveau de la coordonnée 5 11 dans le fichier Ipconfig.out, tapez :

setx IPADDR /f ipconfig.out /a 5,11

Pour définir la variable d’environnement OCTET1 dans l’environnement local sur la valeur trouvée au niveau de la coordonnée 5,3 dans le fichier Ipconfig.out avec des délimiteurs #$*., tapez :

setx OCTET1 /f ipconfig.out /a 5,3 /d #$*.

Pour définir la variable d’environnement IPGATEWAY dans l’environnement local sur la valeur trouvée au niveau de la coordonnée 0,7 par rapport à la coordonnée de passerelle dans le fichier Ipconfig.out, tapez :

setx IPGATEWAY /f ipconfig.out /r 0,7 Gateway

Pour afficher le contenu du fichier Ipconfig.out, ainsi que les coordonnées correspondantes du contenu, sur un ordinateur nommé ordinateur1, tapez :

setx /s computer1 /u maindom\hiropln /p p@ssW23 /f ipconfig.out /x