PowerShell ThreadJob输出正则匹配后$matches首次未填充问题

核心是PowerShell -match 运算符的行为差异 + 全局Job状态残留的双重影响：

1. -match 对单字符串和数组的行为不一致

• 当-match左侧操作数是单个字符串时：匹配成功返回$true，同时会在当前作用域自动填充$matches哈希表，包含所有捕获组的内容。
• 当-match左侧操作数是数组/集合时：匹配成功返回「所有匹配正则的元素组成的子数组」，此时完全不会更新$matches变量，如果当前作用域之前没有$matches，就会返回空值。

2. 首次运行时$DATA为数组
   首次启动az webapp create-remote-connection命令时，工具会先输出若干行前置日志（比如认证信息、资源校验信息等），Receive-Job会一次性把这些已输出的内容全部返回，此时$DATA是包含多行的数组，即使其中某一行匹配到了端口正则，-match返回真但$matches不会被填充，因此$matches.PORT为空。
3. 第二次运行正常的原因
   你的脚本里将CONNECTION声明为$global:全局变量，第一次脚本运行结束后，后台的ThreadJob不会被销毁，仍然在全局作用域存在。第二次运行脚本时，az命令已经完成了前置输出，只剩下端口行等待接收，Receive-Job返回的$DATA是单个字符串，此时-match匹配成功后正常填充$matches，因此可以拿到端口值。

选择以下任意一种方式即可修复：

• 强制每次只匹配单行，避免数组匹配问题：将匹配逻辑改为遍历$DATA的每一行单独匹配

foreach ($line in $DATA) {
    if ($line -match $match_string) {
        $port = $matches.PORT
        Write-Output "Connection open on port $port."
        $done = 1
        break
    }
}

• 不要使用全局Job，避免跨脚本运行的状态残留：去掉$global:修饰符，改为脚本作用域变量，每次运行脚本都启动新的Job

$CONNECTION = Start-ThreadJob -ScriptBlock $BLOCK

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