Setx

**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：常见异常问题