为何PS模块清单中VariablesToExport声明的变量无法导出？

问题分析 #

你在模块清单的VariablesToExport里声明了变量，这些变量定义在NestedModules指定的PSM1文件中，但模块加载后无法访问。核心原因是：NestedModules中的脚本默认运行在模块的私有作用域，变量不会自动被导出，哪怕清单里写了VariablesToExport也没用。VariablesToExport仅对根模块（RootModule指定的PSM1）中定义的变量生效，或者需要显式导出私有作用域里的变量。

解决方案 #

方案1：在NestedModules的PSM1中显式导出变量 #

直接在定义变量的PSM1文件末尾添加Export-ModuleMember命令，指定要导出的变量：

# 先定义变量
$ERROR_SUCCESS  = [ordered]@{
    Number         = 0
    String         = '0'  # The thing the CSV interfaces return 
    HexString      = '0x00000000'                  
}
$ERROR_SUCCESS_REBOOT_REQUIRED = [ordered]@{ ... }
# 其他变量定义...

# 显式导出变量
Export-ModuleMember -Variable ERROR_SUCCESS, ERROR_SUCCESS_REBOOT_REQUIRED, ERROR_INVALID_FUNCTION, WAIT_TIMEOUT, ERROR_FAIL

方案2：将变量移到根模块PSM1中 #

如果你的模块清单指定了RootModule（比如RootModule = 'YourModule.psm1'），把所有要导出的变量定义移到这个根模块文件里。此时清单里的VariablesToExport会自动识别并导出这些变量，无需额外操作。

方案3：验证模块导出状态 #

模块加载后，用以下命令检查变量是否真的被导出：

Get-Module YourModuleName | Select-Object -ExpandProperty ExportedVariables

如果输出里没有目标变量，说明导出配置有问题，回到前面的方案调整。

注意事项 #

• 确保模块清单中的NestedModules路径正确，没有拼写错误或路径问题导致脚本未加载。
• 避免在模块中使用全局作用域（$global:）定义变量，这会污染全局环境，正确的做法是通过模块导出机制共享变量。

内容的提问来源于stack exchange，提问作者deetle