setxsetx

Crée ou modifie des variables d’environnement dans l’environnement utilisateur ou système, sans nécessiter de programmation ou de script.Creates or modifies environment variables in the user or system environment, without requiring programming or scripting. La commande setx récupère également les valeurs des clés de Registre et les écrit dans des fichiers texte.The Setx command also retrieves the values of registry keys and writes them to text files.

SyntaxeSyntax

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ètresParameters

ParamètreParameter DescriptionDescription
commutateur<Computer>/s <Computer> Spécifie le nom ou l’adresse IP d’un ordinateur distant.Specifies the name or IP address of a remote computer. N’utilisez pas de barres obliques inverses.Do not use backslashes. La valeur par défaut est le nom de l’ordinateur local.The default value is the name of the local computer.
GOUDJARATI<Domain>]/u [<Domain>] Exécute le script avec les informations d’identification du compte d’utilisateur spécifié.Runs the script with the credentials of the specified user account. La valeur par défaut est les autorisations système.The default value is the system permissions.
/p [ <Password> ]/p [<Password>] Spécifie le mot de passe du compte d’utilisateur spécifié dans le paramètre /u .Specifies the password of the user account that is specified in the /u parameter.
<Variable> Spécifie le nom de la variable d’environnement que vous souhaitez définir.Specifies the name of the environment variable that you want to set.
<Value> Spécifie la valeur pour laquelle vous souhaitez définir la variable d’environnement.Specifies the value to which you want to set the environment variable.
/k<Path>/k <Path> Spécifie que la variable est définie en fonction des informations d’une clé de registre.Specifies that the variable is set based on information from a registry key. LeHemin p utilise la syntaxe suivante :The path uses the following syntax:
\\<HIVE>\<KEY>\...\<Value>
Par exemple, vous pouvez spécifier le chemin d’accès suivant :For example, you might specify the following path:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName
/f <File name>/f <File name> Spécifie le fichier que vous souhaitez utiliser.Specifies the file that you want to use.
/a <X> ,/a <X>, Spécifie les coordonnées absolues et le décalage en tant que paramètres de recherche.Specifies absolute coordinates and offset as search parameters.
/r <X> , /r <X>, Spécifie les coordonnées relatives et le décalage par rapport à la chaîne en tant que paramètres de recherche.Specifies relative coordinates and offset from String as search parameters.
/m/m Spécifie de définir la variable dans l’environnement système.Specifies to set the variable in the system environment. Le paramètre par défaut est l’environnement local.The default setting is the local environment.
/x/x Affiche les coordonnées des fichiers, en ignorant les options de ligne de commande /a, /ret /d .Displays file coordinates, ignoring the /a, /r, and /d command-line options.
/d<Delimiters>/d <Delimiters> Spécifie des délimiteurs tels que , ou \ à utiliser en plus des quatre délimiteurs intégrés (espace, tabulation, entrée et saut de ligne).Specifies delimiters such as , or \ to be used in addition to the four built-in delimiters — SPACE, TAB, ENTER, and LINEFEED. Les délimiteurs valides incluent n’importe quel caractère ASCII.Valid delimiters include any ASCII character. Le nombre maximal de délimiteurs est 15, y compris les délimiteurs intégrés.The maximum number of delimiters is 15, including built-in delimiters.
/?/? Affiche l'aide à l'invite de commandes.Displays help at the command prompt.

NotesRemarks

  • La commande setx est semblable à l’utilitaire UNIX setenv.The Setx command is similar to the UNIX utility SETENV.
  • Setx fournit la seule ligne de commande ou méthode par programmation pour définir des valeurs d’environnement système directement et de manière permanente.Setx provides the only command-line or programmatic way to directly and permanently set system environment values. Les variables d’environnement système sont configurables manuellement par le biais du panneau de configuration ou d’un éditeur du Registre.System environment variables are manually configurable through Control Panel or through a registry editor. La commande Set , qui est interne à l’interpréteur de commandes (Cmd.exe), définit les variables d’environnement utilisateur uniquement pour la fenêtre de console active.The set command, which is internal to the command interpreter (Cmd.exe), sets user environment variables for the current console window only.
  • Vous pouvez utiliser la commande setx 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.You can use the setx command to set values for user and system environment variables from one of three sources (modes): Command Line Mode, Registry Mode, or File Mode.
  • Setx écrit des variables dans l’environnement maître dans le registre.Setx writes variables to the master environment in the registry. Les variables définies avec des variables setx sont disponibles dans les fenêtres de commande ultérieures uniquement, et non dans la fenêtre de commande active.Variables set with setx variables are available in future command windows only, not in the current command window.
  • HKEY_CURRENT_USER et HKEY_LOCAL_MACHINE sont les seules ruches prises en charge.HKEY_CURRENT_USER and HKEY_LOCAL_MACHINE are the only supported hives. REG_DWORD, REG_EXPAND_SZ, REG_SZ et REG_MULTI_SZ sont les types de données RegKey valides.REG_DWORD, REG_EXPAND_SZ, REG_SZ, and REG_MULTI_SZ are the valid RegKey data types.
  • Lorsque vous accédez à REG_MULTI_SZ valeurs dans le registre, seul le premier élément est extrait et utilisé.When you gain access to REG_MULTI_SZ values in the registry, only the first item is extracted and used.
  • Vous ne pouvez pas utiliser la commande setx pour supprimer des valeurs qui ont été ajoutées à des environnements locaux ou système.You cannot use the setx command to remove values that have been added to the local or system environments. Vous pouvez utiliser Set avec un nom de variable et aucune valeur pour supprimer une valeur correspondante de l’environnement local.You can use set with a variable name and no value to remove a corresponding value from the local environment.
  • REG_DWORD valeurs de Registre sont extraites et utilisées en mode hexadécimal.REG_DWORD registry values are extracted and used in hexadecimal mode.
  • Le mode de fichier prend en charge l’analyse des fichiers texte de retour chariot et de saut de ligne (CRLF) uniquement.File mode supports the parsing of carriage return and line feed (CRLF) text files only.

ExemplesExamples

Pour définir la variable d’environnement de l’environnement local sur la valeur BRAND1, tapez :To set the MACHINE environment variable in the local environment to the value Brand1, type:

setx MACHINE Brand1

Pour définir la variable d’environnement d’ordinateur dans l’environnement système sur la valeur BRAND1 Computer, tapez :To set the MACHINE environment variable in the system environment to the value Brand1 Computer, type:

setx MACHINE Brand1 Computer /m

Pour définir la variable d’environnement MYPATH dans l’environnement local afin d’utiliser le chemin de recherche défini dans la variable d’environnement PATH, tapez :To set the MYPATH environment variable in the local environment to use the search path defined in the PATH environment variable, type:

setx MYPATH %PATH%

Pour définir la variable d’environnement MYPATH dans l’environnement local afin d’utiliser le chemin de recherche défini dans la variable d’environnement PATH après le remplacement ~ de par % , tapez :To set the MYPATH environment variable in the local environment to use the search path defined in the PATH environment variable after replacing ~ with %, type:

setx MYPATH ~PATH~

Pour définir la variable d’environnement de l’environnement local sur Brand1 sur un ordinateur distant nommé Ordinateur1, tapez :To set the MACHINE environment variable in the local environment to Brand1 on a remote computer named Computer1, type:

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

Pour définir la variable d’environnement MYPATH dans l’environnement local afin d’utiliser le chemin de recherche défini dans la variable d’environnement PATH sur un ordinateur distant nommé Ordinateur1, tapez :To set the MYPATH environment variable in the local environment to use the search path defined in the PATH environment variable on a remote computer named Computer1, type:

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

Pour définir la variable d’environnement TZONE dans l’environnement local à la valeur trouvée dans la clé de Registre HKEY_LOCAL_MACHINE \system\currentcontrolset\control\timezoneinformation\standardname , tapez :To set the TZONE environment variable in the local environment to the value found in the HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName registry key, type:

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é Computer1 sur la valeur trouvée dans la clé de Registre HKEY_LOCAL_MACHINE \system\currentcontrolset\control\timezoneinformation\standardname , tapez :To set the TZONE environment variable in the local environment of a remote computer named Computer1 to the value found in the HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName registry key, type:

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 de génération dans l’environnement système sur la valeur trouvée dans la clé de Registre HKEY_LOCAL_MACHINE \software\microsoft\windowsnt\currentversion\currentbuildnumber , tapez :To set the BUILD environment variable in the system environment to the value found in the HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber registry key, type:

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

Pour définir la variable d’environnement de génération 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 :To set the BUILD environment variable in the system environment of a remote computer named Computer1 to the value found in the HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber registry key, type:

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, avec les coordonnées correspondantes, tapez :To display the contents of a file named Ipconfig.out, along with the contents' corresponding coordinates, type:

setx /f ipconfig.out /x

Pour définir la variable d’environnement IPADDR dans l’environnement local à la valeur trouvée aux coordonnées 5, 11 dans le fichier ipconfig. out, tapez :To set the IPADDR environment variable in the local environment to the value found at the coordinate 5,11 in the file Ipconfig.out, type:

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

Pour définir la variable d’environnement octet1 dans l’environnement local à la valeur trouvée aux coordonnées 5, 3 dans le fichier ipconfig. out avec des délimiteurs ** #$ * .**, tapez :To set the OCTET1 environment variable in the local environment to the value found at the coordinate 5,3 in the file Ipconfig.out with delimiters #$*., type:

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

Pour définir la variable d’environnement IPGATEWAY dans l’environnement local à la valeur trouvée à la coordonnée 0, 7 en ce qui concerne la coordonnée de la passerelle dans le fichier ipconfig. out, tapez :To set the IPGATEWAY environment variable in the local environment to the value found at the coordinate 0,7 with respect to the coordinate of Gateway in the file Ipconfig.out, type:

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

Pour afficher le contenu d’un fichier nommé ipconfig. out, ainsi que les coordonnées correspondantes, sur un ordinateur nommé Ordinateur1, tapez :To display the contents of a file named Ipconfig.out — along with the contents' corresponding coordinates — on a computer named Computer1, type:

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

Références supplémentairesAdditional References