PowerShell中-in运算符仅提前引用数组后生效的问题排查

现象原因 #

出现该问题的核心是 $odSyncedValues的实际类型并非PowerShell标准数组（[object[]]），而是其他可枚举类型（如ArrayList、单元素字符串/对象），导致-in运算符无法正确执行成员匹配：

• 若$odSyncedValues是ArrayList这类非标准集合，部分PowerShell版本（如5.1）的-in运算符无法正确遍历其元素做匹配；
• 若$odSyncedValues是单个字符串（比如从文件读取仅一行内容、命令返回单个结果），-in会将字符串拆解为字符数组，检查$status是否为单个字符，自然匹配失败。

单独引用$odSyncedValues时，PowerShell会隐式将其转换为标准[object[]]数组，因此-in能恢复正常匹配。

无需额外引用变量的解决方法 #

你可以通过以下几种方式直接修复函数：

1. 强制定义为标准数组 #

在赋值时用@()包裹内容或命令输出，确保变量是严格的数组类型：

function Test-SPFolderSyncStatus {
    # 直接定义为标准数组
    $odSyncedValues = @("已同步", "同步中")
    # 若从命令获取结果，同样用@()强制转换
    # $odSyncedValues = @(Get-Content .\syncStatusConfig.txt)
    
    $status = Get-ODCurrentSyncStatus # 替换为你的状态获取逻辑
    if ($status -in $odSyncedValues) {
        return $true
    }
    return $false
}

2. 改用-contains运算符 #

-contains是数组原生方法，会自动处理非标准可枚举集合的隐式转换，逻辑与-in等价（仅左右操作数顺序相反）：

function Test-SPFolderSyncStatus {
    $odSyncedValues = New-Object System.Collections.ArrayList
    $odSyncedValues.Add("已同步") | Out-Null
    $odSyncedValues.Add("同步中") | Out-Null
    
    $status = Get-ODCurrentSyncStatus
    # 用-contains替代-in，交换左右操作数顺序
    if ($odSyncedValues -contains $status) {
        return $true
    }
    return $false
}

3. 显式类型转换为数组 #

通过[array]标记强制转换变量为标准数组：

function Test-SPFolderSyncStatus {
    # 显式转换为数组类型
    [array]$odSyncedValues = Get-ODSyncStatusOptions # 假设此命令返回非标准集合
    
    $status = Get-ODCurrentSyncStatus
    if ($status -in $odSyncedValues) {
        return $true
    }
    return $false
}

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