Import-PowerShellDataFile导入PSD1后脚本块执行异常排查

我尝试调用通过Import-PowerShellDataFile导入的PSD1文件中的PowerShell脚本块时出现异常。直接定义哈希表中的脚本块可以正常执行：

$Config = @{
    test = {Write-output "Hello"}
}
$config.test.invoke()
# 输出: Hello

但通过PSD1文件导入后调用，结果并不是预期的执行输出，而是返回脚本块的代码文本：

$tmpConfig = Import-PowerShellDataFile -Path tmpconfig.psd1
$tmpconfig.test.Invoke()
# 输出: Write-Output "Hello"

进一步观察发现，导入后的脚本块调用ToString()会显示多一层大括号，相当于$t = {{Write-Output 'Hello'}}，虽然可以通过两次调用Invoke()来执行，但不清楚为什么Import-PowerShellDataFile会对脚本块做双重包裹。

原因分析 #

• Import-PowerShellDataFile的设计定位是安全导入数据文件，它会将PSD1中的脚本块作为字符串解析后，再重新包装成一个脚本块。也就是说，PSD1里的{ Write-output "Hello" }会被解析为一个包含{ Write-output "Hello" }文本的脚本块，而非直接解析为可执行该命令的脚本块，最终形成了嵌套结构。
• 对比直接定义哈希表或使用[scriptblock]::Create()解析脚本的方式，后者是直接将哈希表定义解析为包含可执行脚本块的哈希表，不存在额外嵌套。

解决方法 #

有两种可行的解决方式：

方式1：双重调用脚本块 #

利用嵌套结构的特点，先调用外层脚本块得到真正要执行的内层脚本块，再执行一次：

$tmpConfig = Import-PowerShellDataFile -Path tmpconfig.psd1
# 先获取内层可执行脚本块，再执行
$innerScript = $tmpConfig.test.InvokeReturnAsIs()
$innerScript.InvokeReturnAsIs()
# 输出: Hello

方式2：重新解析脚本块内容 #

提取导入后脚本块的文本内容，去掉外层的大括号，重新创建一个可执行的脚本块：

$tmpConfig = Import-PowerShellDataFile -Path tmpconfig.psd1
# 去除脚本块文本首尾的大括号和空白字符
$scriptText = $tmpConfig.test.ToString().Trim('{}').Trim()
$realScript = [scriptblock]::Create($scriptText)
$realScript.InvokeReturnAsIs()
# 输出: Hello

复现信息 #

输出对比 #

# 通过Import-PowerShellDataFile导入的结果
ConfigType : System.Collections.Hashtable
Value      : {Write-output "Hello"}
ValueType  : System.Management.Automation.ScriptBlock
Result     : Write-output "Hello"
ResultType : System.Management.Automation.ScriptBlock

# 直接解析哈希表的结果
ConfigType : System.Collections.Hashtable
Value      : Write-output "Hello"
ValueType  : System.Management.Automation.ScriptBlock
Result     : Hello
ResultType : System.String

完整复现脚本 #

$tmpconfigstring = @'
@{
    test = { Write-output "Hello" }
}
'@ 

$tmpconfigstring | Out-File tmpconfig.psd1

$tmpConfig = Import-PowerShellDataFile -Path tmpconfig.psd1
$tmpconfig2 = ([scriptblock]::Create($tmpconfigstring)).InvokeReturnAsIs()

$Result = $tmpConfig.test.InvokeReturnAsIs()
$Result2 = $tmpconfig2.test.InvokeReturnAsIs()


[PSCustomObject]@{
    'ConfigType' = $tmpConfig.GetType() 
    'Value'      = $tmpConfig.test.ToString() 
    'ValueType'  = $tmpconfig.test.GetType()
    'Result'     = $Result
    'ResultType' = $Result.GetType()
} | fl 

[PSCustomObject]@{
    'ConfigType' = $tmpConfig2.GetType() 
    'Value'      = $tmpConfig2.test.ToString() 
    'ValueType'  = $tmpconfig2.test.GetType()
    'Result'     = $Result2
    'ResultType' = $Result2.GetType()
} | fl 

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