设置环境变量

UiPath.Core.Activities.SetEnvironmentVariable

使用此活动设置环境变量，并为其提供名称和值。如果该变量尚不存在，则系统会自动创建该变量。

备注：

在 Windows 上，此活动会设置用户 环境变量。在跨平台项目上，它会设置流程环境变量。对于解释获取环境变量和设置环境变量活动在 Windows 和跨平台上的差异，了解如何将环境变量从“计算机”级别和“用户”级别加载到“流程”作用域中非常重要。

属性

常见

• “显示名称”- 活动的显示名称。此字段仅支持 Strings 或 String 变量。

输入

• “名称”- 新环境变量的名称。此字段仅支持 Strings 或 String 变量。
• “值”- 新环境变量的值。此字段仅支持 Strings 或 String 变量。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

特定于平台的行为

Windows 环境

在 Windows（默认配置）上运行时：

• 在用户级别 ( EnvironmentVariableTarget.User ) 上设置环境变量。
• 更改将在当前流程之外保留，并存储在 Windows 注册表中。
• 该变量可用于当前用户启动的新流程。
• 需要适当的权限才能修改用户级环境变量。

跨平台环境

在跨平台系统（Linux 、macOS）上运行时：

• 在流程级别（ EnvironmentVariableTarget.Process ）设置环境变量。
• 更改是临时性的，只会影响当前流程及其子流程。
• 流程终止后不会保留变量。
• 无需特殊权限，因为更改的作用域为当前流程。

技术详情

该活动使用内部TargetFramework属性来确定执行上下文。此行为由 UiPath 运行时根据项目类型自动确定，无法通过活动属性进行配置。

最佳实践

• 对于 Windows 工作流，当变量必须在流程重新启动后保留或可供其他应用程序使用时，请使用此活动。
• 对于跨平台工作流，请规划流程级别的作用域，并在需要时使用替代暂留方法（配置文件、数据库）。
• 对于可移植工作流，在设计时需假设流程级别的作用域，以确保跨平台的行为一致。

验证

该活动验证“名称”参数不为 null 或为空，以及是否已提供所有必需参数。无效操作会引发带有描述性错误消息的InvalidOperationException 。