System command

setx command

Creates or modifies environment variables in the user or system environment, without requiring programming or scripting. This guide lists the documented syntax and parameters for setx; check Microsoft Learn for version, role and execution-context requirements.

Availability: Microsoft Learn command reference spanning Windows client and Windows Server releases; some entries are legacy, role-specific, optional-feature or interactive subcommands.中文

Documented syntax

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>]

The linked Microsoft Learn article is the upstream authority. Availability may depend on Windows release, role, optional feature or interactive tool context.

Syntax pattern

Syntax pattern from Microsoft Learn; replace placeholders and choose only one documented alternative before use.

setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]] <variable> <value> [/m]

Parameters, options and clauses

Option / clauseDescription
/sMicrosoft documents this switch; use the linked reference for accepted values, effects and version limits.
<computer>Microsoft documents this argument or subcommand; check the linked reference for its required format and context.
/uMicrosoft documents this switch; use the linked reference for accepted values, effects and version limits.
<domain>Microsoft documents this argument or subcommand; check the linked reference for its required format and context.
/pMicrosoft documents this switch; use the linked reference for accepted values, effects and version limits.
<password>Microsoft documents this argument or subcommand; check the linked reference for its required format and context.
<variable>Microsoft documents this argument or subcommand; check the linked reference for its required format and context.
<value>Microsoft documents this argument or subcommand; check the linked reference for its required format and context.
/mMicrosoft documents this switch; use the linked reference for accepted values, effects and version limits.
/kMicrosoft documents this switch; use the linked reference for accepted values, effects and version limits.
<path>Microsoft documents this argument or subcommand; check the linked reference for its required format and context.
/fMicrosoft documents this switch; use the linked reference for accepted values, effects and version limits.
<filename>Microsoft documents this argument or subcommand; check the linked reference for its required format and context.
/aMicrosoft documents this switch; use the linked reference for accepted values, effects and version limits.
<X>Microsoft documents this argument or subcommand; check the linked reference for its required format and context.
<Y>Microsoft documents this argument or subcommand; check the linked reference for its required format and context.
/rMicrosoft documents this switch; use the linked reference for accepted values, effects and version limits.
<String>Microsoft documents this argument or subcommand; check the linked reference for its required format and context.
/xMicrosoft documents this switch; use the linked reference for accepted values, effects and version limits.
/dMicrosoft documents this switch; use the linked reference for accepted values, effects and version limits.
<delimiters>Microsoft documents this argument or subcommand; check the linked reference for its required format and context.
Safety note

Review a command and its target before running it. Commands that alter files, services, accounts, disks, permissions or databases may be difficult to reverse. Test in a safe environment and keep backups.

Official reference ↗Back to directory