使用Import-Module时函数返回HashTable遇类型转换问题求解决

问题场景 #

主脚本通过指定配置名称导入对应PowerShell模块，要求模块必须导出GetSections函数，且该函数返回HashTable供后续逻辑使用。

主脚本核心代码：

$MigrationConfig = 'Migrate.Default'
$MigrationConfigPath = '.\MigrationConfigs\' + $MigrationConfig + '.psm1'
Import-Module -Name $MigrationConfigPath

if (((Get-Command -Module $MigrationConfig -ListImported) | Where-Object Name -eq 'GetSections').Length -ne 1) {
    throw "Migration Config $MigrationConfig which should be located at $MigrationConfigPath must export a function named 'GetSections'."
}

模块示例代码（Migrate.Default.psm1）：

function GetSections {
    return [HashTable]@{
        'MigrationProc' = [ordered]@{
            '1' = @{} # 实际逻辑内容
        }
    }
}

测试时执行以下代码出现类型转换错误：

foreach($f in ((Get-Command -Module 'Migrate.Default' -ListImported) | Where-Object Name -eq 'GetSections')) {
    ([HashTable]([ScriptBlock]::Create($f.ScriptBlock).Invoke('1'))).Keys
}

错误信息：

Cannot convert the "System.Collections.ObjectModel.Collection`1[System.Management.Automation.PSObject]" value of type 
"System.Collections.ObjectModel.Collection`1[[System.Management.Automation.PSObject, System.Management.Automation, Version=3.0.0.0, 
Culture=neutral, PublicKeyToken=31bf3856ad364e35]]" to type "System.Collections.Hashtable".

错误原因 #

[ScriptBlock]::Invoke()方法的返回值是**System.Collections.ObjectModel.Collection<PSObject>**，即使函数只返回单个HashTable，也会被包裹在这个集合对象中。直接将整个集合强制转换为HashTable必然失败。

解决方法 #

1. 主脚本中正确调用函数（推荐） #

不需要通过Get-Command和ScriptBlock.Invoke()绕弯，导入模块后直接调用函数即可，PowerShell会自动返回函数的实际输出类型：

# 导入模块后直接调用
$sections = GetSections
# 验证类型
$sections.GetType().FullName # 输出 System.Collections.Hashtable
# 直接操作HashTable
$sections.Keys

2. 修正测试代码的调用方式（仅用于特殊场景） #

如果必须通过ScriptBlock执行，需从返回的集合中提取第一个元素再转换：

foreach($f in ((Get-Command -Module 'Migrate.Default' -ListImported) | Where-Object Name -eq 'GetSections')) {
    # 提取集合的第一个元素再转换为HashTable
    $result = [HashTable]([ScriptBlock]::Create($f.ScriptBlock).Invoke('1')[0])
    $result.Keys
}

3. 模块函数的优化（可选） #

模块中的return语句可以简化，PowerShell会自动识别哈希表字面量的类型，无需显式强制转换（但显式转换也没问题）：

function GetSections {
    @{
        'MigrationProc' = [ordered]@{
            '1' = @{}
        }
    }
}

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