大网数据广告活动
Windows排障命令

Windows Server 命令与管理 — setx

· 52CE 我爱测

Setx 命令的参考文章,用于在用户或系统环境中创建或修改环境变量,无需编程或编写脚本。

在用户或系统环境中创建或修改环境变量,无需编程或编写脚本。 Setx 命令还检索注册表项的值,并将它们写入文本文件。

Note: 此命令提供了唯一直接、永久地设置系统环境值的命令行或编程方式。 可以通过 "控制面板" 或通过注册表编辑器手动配置系统环境变量。 Set 命令(在命令解释器内部 (Cmd.exe) )仅为当前控制台窗口设置用户环境变量。

语法

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

参数

参数 说明
/s <computer> 指定远程计算机的名称或 IP 地址。 不要使用反斜杠。 默认值为本地计算机的名称。
/u [<domain>\]<user name> 用指定用户帐户的凭据运行脚本。 默认值为 "系统权限"。
/p [ <password> ] 指定在 /u 参数中指定的用户帐户的密码。
<variable> 指定要设置的环境变量的名称。
<value> 指定要将环境变量设置为的值。
遇到 <path> 指定根据注册表项中的信息设置变量。 该 路径 使用以下语法: \\<HIVE>\<KEY>\...\<Value> 。 例如,你可以指定以下路径: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName
/f <filename> 指定要使用的文件。
/a <X>,<Y> 指定绝对坐标,偏移量作为搜索参数。
/r <X>,<Y> <String> 指定相对坐标和作为搜索参数的 字符串 的偏移量。
/m 指定在系统环境中设置变量。 默认设置为本地环境。
/x 显示文件坐标,并忽略 /a、 /r 和 /d 命令行选项。
/d <delimiters> 指定除 、 \ 空格、制表符、回车和换行以外,还可以使用除四个内置分隔符以外的分隔符。 有效的分隔符包含任何 ASCII 字符。 最大分隔符数为15,其中包括内置分隔符。
/? 在命令提示符下显示帮助。
备注
  • 此命令类似于 UNIX 实用工具 SETENV。

  • 你可以使用此命令从以下三个源之一 (模式设置用户和系统环境变量的值) :命令行模式、注册表模式或文件模式。

  • 此命令将变量写入注册表中的主环境。 使用 setx 变量设置的变量仅在以后的命令窗口中可用,而不能在当前的命令窗口中使用。

  • HKEY_CURRENT_USER 和 HKEY_LOCAL_MACHINE 是唯一受支持的配置单元。 REG_DWORD、REG_EXPAND_SZ、REG_SZ 和 REG_MULTI_SZ 都是有效的 RegKey 数据类型。

  • 如果获得对注册表中 REG_MULTI_SZ 值的访问权限,则只提取并使用第一项。

  • 无法使用此命令删除添加到本地或系统环境的值。 可以将此命令与变量名称和无值一起使用,以从本地环境中删除相应的值。

  • REG_DWORD 在十六进制模式下提取和使用注册表值。

  • 文件模式支持仅) 文本文件 (CRLF 分析回车符和换行。

  • 对现有变量运行此命令将删除所有变量引用并使用扩展值。

    例如,如果变量% PATH% 引用了% JAVADIR%,而使用 setx 操作了% path%,则将展开% JAVADIR%,并将其值直接分配给目标变量% PATH%。 这意味着,% JAVADIR% 的将来更新 将不 会反映在% PATH% 变量中。

  • 请注意,使用 setx 将内容分配到变量时,会出现1024个字符的限制。

    这意味着,如果您超过1024个字符,则会裁剪内容,并且裁剪后的文本会应用于目标变量。 如果此裁剪文本应用于现有变量,则可能会导致目标变量以前保存的数据丢失。

示例

若要将本地环境中的 计算机 环境变量设置为 Brand1 值,请键入:

setx MACHINE Brand1

若要将系统环境中的 计算机 环境变量设置为值 Brand1 计算机,请键入:

setx MACHINE Brand1 Computer /m

若要将本地环境中的 MYPATH 环境变量设置为使用 path 环境变量中定义的搜索路径,请键入:

setx MYPATH %PATH%

若要在将替换为之后将本地环境中的 MYPATH 环境变量设置为使用 path 环境变量中定义的搜索路径 ~ % ,请键入:

setx MYPATH ~PATH~

若要在名为 computer1 的远程计算机上将本地环境中的 计算机 环境变量设置为 Brand1 ,请键入:

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

若要在本地环境中设置 MYPATH 环境变量以使用在名为 computer1 的远程计算机上的 path 环境变量中定义的搜索路径,请键入:

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

若要将本地环境中的 TZONE 环境变量设置为在 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName 注册表项中找到的值,请键入:

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

若要将名为 computer1 的远程计算机的本地环境中的 TZONE 环境变量设置为 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName 注册表项中找到的值,请键入:

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

若要在系统环境中将 生成 环境变量设置为在 HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber 注册表项中找到的值,请键入:

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

若要在名为 Computer1 的远程计算机的系统环境中将生成环境变量设置为在 HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber 注册表项中找到的值,请键入:

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

若要显示名为 Ipconfig. out 的文件的内容,以及内容的对应坐标,请键入:

setx /f ipconfig.out /x

若要将本地环境中的 IPADDR 环境变量设置为在 文件的 坐标 5,11 中找到的值,请键入:

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

若要将本地环境中的 OCTET1 环境变量设置为在文件中的坐标 5、3 处找到的值,请在带有分隔符 **# $ *** 的 Ipconfig 文件中键入:

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

若要将本地环境中的 IPGATEWAY 环境变量设置为在 文件的**网关 坐标中的坐标 0、7 上找到的值,请键入:

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

若要在名为 computer1 的计算机上显示 Ipconfig 文件的内容以及内容的对应坐标,请键入:

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

其他参考

历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 JasonGerend)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Windows Server 中文文档历史快照
适用范围
历史中文快照 2021-03-23;详见原文产品版本;文档日期 10/16/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。