PowerShell函数中操作全局Hashtable报错的解决方法

问题场景 #

本地Hashtable $local_Vertraege 可通过 += 正常添加数据，但操作全局Hashtable $global:Vertraege 时抛出异常：赋值表达式无效。赋值运算符的输入必须是可接受赋值的对象（如变量或属性）。

相关代码示例：

$global:Vertraege = @{}

function xy
{
 #local access is working
   $local_Vertraege = @{}

   $local_Vertraege += ( @{ i=1; ag="AG1"; we="WE1" } )
   $local_Vertraege += ( @{ i=2; ag="AG2"; we="WE2" } )
   $local_Vertraege += ( @{ i=3; ag="AG2"; we="WE3" } )
#global access is not working, throws exception, why?
   $global:Vertraege += ( @{ i=4; ag="AG4"; we="WE4" } )
}

问题原因 #

+= 运算符对Hashtable的作用是创建新的Hashtable并覆盖原变量，而非直接修改原Hashtable对象。当操作全局变量时，$global:Vertraege += ... 的写法会被PowerShell解析为尝试将新Hashtable赋值给一个带限定符的表达式（而非直接变量引用），导致语法错误。本地变量因为是单纯的变量名，所以$local_Vertraege += ... 可以正常解析为覆盖原变量。

解决方案 #

有两种可靠方式修改全局Hashtable：

方式1：使用Hashtable原生方法添加数据 #

直接调用Hashtable的Add()方法，或通过键名赋值的方式添加（键已存在时会覆盖）：

# 使用Add方法（键不存在时可用）
$global:Vertraege.Add("4", @{ i=4; ag="AG4"; we="WE4" })

# 或通过键名直接赋值（兼容键存在的情况）
$global:Vertraege["4"] = @{ i=4; ag="AG4"; we="WE4" }

方式2：本地修改后覆盖全局变量 #

如果需要批量添加数据，可先将全局Hashtable赋值给本地变量修改，再写回全局：

$temp = $global:Vertraege
$temp += @{ i=4; ag="AG4"; we="WE4" }
$global:Vertraege = $temp

优化后的完整代码示例 #

$global:Vertraege = @{}

function xy
{
    # 本地Hashtable正常操作
    $local_Vertraege = @{}
    $local_Vertraege += @{ i=1; ag="AG1"; we="WE1" }
    $local_Vertraege += @{ i=2; ag="AG2"; we="WE2" }
    $local_Vertraege += @{ i=3; ag="AG2"; we="WE3" }

    # 方式1：使用Add方法修改全局Hashtable
    $global:Vertraege.Add("4", @{ i=4; ag="AG4"; we="WE4" })

    # 可选：用键名赋值添加另一组数据
    # $global:Vertraege["5"] = @{ i=5; ag="AG5"; we="WE5" }

    # 方式2：本地修改后覆盖全局（可批量操作）
    # $temp = $global:Vertraege
    # $temp += @{ i=6; ag="AG6"; we="WE6" }
    # $global:Vertraege = $temp
}

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