**setx**是一个微软Window操作系统的一个管理工具/命令。setx是英文**S**et **X**，即用于设置环境变量，是Windows系统中运维需要的命令。

历史
--

适用于：Windows Vista, Windows Server 2008, Windows Server 2012, Windows 8，Windows 10

setx首次出现于Windows Vista.

使用方法
----

在操作系统中都有环境变量的概念，表示操作系统中用来指定操作系统运行环境的一些参数。

该命令 setx 用于 不依赖脚本和编程，直接创建或者修改 用户或者系统的环境变量。并可用于检索注册表项的值并将它们写进文本文件。

语法
--

语法 1:

```
   SETX [/S system [/U [domain\]user [/P [password]]]] var value [/M]
```

语法 2:

```
   SETX [/S system [/U [domain\]user [/P [password]]]] var /K regpath [/M]
```

语法 3:

```
   SETX [/S system [/U [domain\]user [/P [password]]]]
        /F file {var {/A x,y | /R x,y string}[/M] | /X} [/D delimiters]
```

描述:

```
   在用户或系统环境创建或修改环境变量。能基于参数、注册表项或文件输
   入设置变量。
```

参数列表
----

```
   /S     system          指定要连接到的远程系统。
```

```
   /U     [domain\]user   指定应该在哪个用户上下文执行命令。
```

```
   /P     [password]      指定给定用户上下文的密码。如果省略则
                          提示输入。
```

```
   var                    指定要设置的环境变量。
```

```
   value                  指定分配给环境变量的值。
```

```
   /K     regpath         指定变量是基于注册表项的信息而设置的。
```

```
                          路径的格式应该是 hive\key\...\value。例如
                          HKEY_LOCAL_MACHINE\System\CurrentControlSet\
                          Control\TimeZoneInformation\StandardName。
```

```
   /F     file            指定要使用的文本文件的文件名。
```

```
   /A     x,y             指定绝对文件坐标(线 X，项目 Y)作为在此文件
                          里搜索的参数。
```

```
   /R     x,y string      指定有关"字符串"作为搜索参数的相对文件坐标。
```

```
   /M                     指定应该在系统 (HKEY_LOCAL_MACHINE) 环境中设
                          置此变量。在 HKEY_CURRENT_USER 环境下，默认
                          将设置此变量。
```

```
   /X                     用 x，y 坐标显示文件内容。
```

```
   /D     delimiters      指定其他限定符，如 "," 或 "\"。
                          内置分隔符是空格、制表符、回车和换行符。所有
                          ASCII 字符都可作为限定符。限定符的最大数量，
                          包括内置分隔符，是 15。
```

```
   /?                     显示此帮助消息。
```

注意
--

```
     1) SETX 在注册表中将变量写入主机环境。
     2) 在本地系统，用此工具创建或修改的变量将在以后的命令窗口可用，但
        在当前的 CMD.exe 命令窗口。
     3) 在远程系统，用此工具创建或修改的变量在下次登录会话可用。
     4) 有效的注册表项数据类型是 REG_DWORD，REG_EXPAND_SZ，REG_SZ
        和 REG_MULTI_SZ。
     5) 受支持的配置单元:  HKEY_LOCAL_MACHINE (HKLM)，
        HKEY_CURRENT_USER (HKCU)。
     6) 限定符区分大小写。
     7) REG_DWORD 的值是从注册表里以十进制格式提取出来的。
```

示例
--

```
   SETX MACHINE COMPAQ
   SETX MACHINE "COMPAQ COMPUTER" /M
   SETX MYPATH "%PATH%"
   SETX MYPATH ~PATH~
   SETX /S system /U user /P password  MACHINE COMPAQ
   SETX /S system /U user /P password MYPATH ^%PATH^%
   SETX TZONE /K HKEY_LOCAL_MACHINE\System\CurrentControlSet\
        Control\TimeZoneInformation\StandardName
   SETX BUILD /K "HKEY_LOCAL_MACHINE\Software\Microsoft\Windows
        NT\CurrentVersion\CurrentBuildNumber" /M
   SETX /S system /U user /P password TZONE /K HKEY_LOCAL_MACHINE\
        System\CurrentControlSet\Control\TimeZoneInformation\
        StandardName
   SETX /S system /U user /P password  BUILD /K
        "HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\
        CurrentVersion\CurrentBuildNumber" /M
   SETX /F ipconfig.out /X
   SETX IPADDR /F ipconfig.out /A 5,11
   SETX OCTET1 /F ipconfig.out /A 5,3 /D "#$*."
   SETX IPGATEWAY /F ipconfig.out /R 0,7 Gateway
   SETX /S system /U user /P password  /F c:\ipconfig.out /X
```

参看
--

* MS-DOS命令列表#set :设置环境变量（只在当前命令窗口）。
* setx：常见异常问题