PowerShell Out-GridView弹窗异常及多值拆分选择实现方法

场景说明 #

在PowerShell 5.1 WinForms环境下开发网卡接口属性展示UI，已实现网卡路由数据采集逻辑，需要为目标前缀选择按钮绑定交互：点击按钮后弹出选择窗口，从所有接口关联的1~n个目标前缀（DestinationPrefix）中选择单个值存入$selectedDestination供后续业务调用。

原有实现代码 #

路由采集逻辑 #

function Get-InterfaceRoutes {

    $interfaceIPs = Get-NetIPConfiguration -Detailed |
     Where-Object { $_.netadapter.status -eq 'up' } | Get-NetIPAddress -AddressFamily IPv4 | 
     Select-Object -Property IPAddress, InterfaceIndex, InterfaceAlias

    Foreach ($interfaceIP in $interfaceIPs) {
        $route = Get-NetRoute -InterfaceIndex ($interfaceIP.InterfaceIndex) | 
         Select-Object -Property ifINdex, DestinationPrefix, NextHop, RouteMetric, ifMetric | 
         Where-Object -Property DestinationPrefix -like '*.*.*.*' | Sort-Object -Property ifIndex

        [PSCustomObject]@{
            Index             = ($interfaceIp.InterfaceIndex)
            Address           = ($interfaceIP.IPAddress)
            Alias             = ($interfaceIP.InterfaceAlias)
            DestinationPrefix = ($route.DestinationPrefix)
            NextHop           = ($route.NextHop)
            RouteMetric       = ($route.RouteMetric)
            InterfaceMetric   = ($route.InterfaceMetric)
        }
    }
}
$collection = @(Get-InterfaceRoutes)

按钮初始点击事件 #

$destinationSelectButton.Add_Click({
        $selectedDestination = $collection.keys | 
         Out-GridView -Title "Select Destination Prefix" -PassThru | 
         ForEach-Object { $_.Values } | Select-Object -Property DestinationPrefix
    
        Write-Host $selectedDestination | Out-String
    })

调整后可弹窗但显示异常的代码 #

$destinationSelectButton.Add_Click({
        $selectedDestination = $collection |
         Out-Gridview -Title "Select Destination Prefix" -PassThru | 
         Select-Object -Property DestinationPrefix
    })

问题根因 #

1. 初始代码Out-GridView不弹窗：$collection是自定义对象组成的索引数组，不是哈希表结构，不存在.Keys属性，传入管道的内容为空值，Out-GridView无内容可渲染因此不会弹出，且该场景不会触发终止性错误，无报错提示。部分场景下如果PowerShell运行在MTA线程模式，WinForms事件中调用Out-GridView也会出现无响应不弹窗的问题。
2. 直接传$collection时内容聚合：原采集逻辑中，每个网卡接口下的所有路由条目被整体打包为一个自定义对象，同接口下的多个DestinationPrefix以数组形式存储在单个对象属性中，Out-GridView原生不支持自动展开数组属性为独立行，因此会把整组前缀聚合显示在同一个单元格中，无法拆分选择。

修复方案 #

第一步：修改路由采集逻辑，拆分单条路由为独立平面对象 #

不再把同接口的所有路由打包为一个对象，而是遍历接口下的每一条路由，生成独立的条目，保证每个对象对应一个唯一的DestinationPrefix：

function Get-InterfaceRoutes {
    $interfaceIPs = Get-NetIPConfiguration -Detailed |
     Where-Object { $_.netadapter.status -eq 'up' } | Get-NetIPAddress -AddressFamily IPv4 | 
     Select-Object -Property IPAddress, InterfaceIndex, InterfaceAlias

    Foreach ($interfaceIP in $interfaceIPs) {
        # 先获取当前接口下所有符合要求的路由
        $routes = Get-NetRoute -InterfaceIndex $interfaceIP.InterfaceIndex | 
         Where-Object -Property DestinationPrefix -like '*.*.*.*' | 
         Sort-Object -Property ifIndex
        # 遍历每条路由生成独立对象
        foreach ($route in $routes) {
            [PSCustomObject]@{
                Index             = $interfaceIP.InterfaceIndex
                Address           = $interfaceIP.IPAddress
                Alias             = $interfaceIP.InterfaceAlias
                DestinationPrefix = $route.DestinationPrefix
                NextHop           = $route.NextHop
                RouteMetric       = $route.RouteMetric
                InterfaceMetric   = $route.ifMetric
            }
        }
    }
}
$collection = @(Get-InterfaceRoutes)

第二步：修正按钮点击事件逻辑 #

明确变量作用域，直接传入拆分后的平面对象到Out-GridView，确保选择结果可被后续逻辑访问：

$destinationSelectButton.Add_Click({
    # 弹出选择窗口，只取用户选中的第一条结果（满足单选需求）
    $selectedItem = $collection |
     Out-GridView -Title "选择目标前缀" -PassThru |
     Select-Object -First 1
    # 将选中的前缀存入脚本级作用域，供后续逻辑调用，可根据需求调整为全局作用域$global:selectedDestination
    $script:selectedDestination = $selectedItem.DestinationPrefix
    Write-Host "已选中目标前缀：$script:selectedDestination"
})

补充注意事项 #

如果修改后仍出现Out-GridView不弹窗的问题，确认启动PowerShell时添加-STA参数，WinForms和Out-GridView都要求运行在单线程套间（STA）模式下，PowerShell 5.1默认启动为STA模式，自定义托管或特殊启动场景下需要手动指定。

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