如何解决PowerShell报错：Test-NetConnection找不到接受参数'if'的位置参数

错误原因 #

这个报错是因为PowerShell解析脚本时，把if当成了Test-NetConnection命令的位置参数，通常由以下情况导致：

• 脚本复制过程中格式错乱，Test-NetConnection命令行和后续if语句未正确换行，连在了同一行
• 占位符<<file_share_name>>未替换为实际Azure存储账户名称，导致命令语法不完整
• 脚本中存在不可见特殊字符，干扰了PowerShell的语法解析

修复步骤 #

1. 替换占位符：将脚本中所有<<file_share_name>>替换为你实际的Azure存储账户名称，确保无遗漏
2. 修正脚本格式：确保每一行命令独立换行，尤其是Test-NetConnection结尾和if语句开头分属不同行，修正后的脚本示例：

$connectTestResult = Test-NetConnection -ComputerName your-storage-account.file.core.windows.net -Port 445
if ($connectTestResult.TcpTestSucceeded) {
 # 挂载驱动器
 New-PSDrive -Name M -PSProvider FileSystem -Root "\\your-storage-account.file.core.windows.net\u-brandonp" -Persist
} else {
 Write-Error -Message "无法通过445端口连接到Azure存储账户。请检查组织或ISP是否阻止了445端口，或使用Azure P2S VPN、Azure S2S VPN或Express Route通过其他端口传输SMB流量。"
}

3. 清理特殊字符：若替换占位符和修正格式后仍报错，将脚本内容复制到纯文本编辑器（如记事本）重新保存，去除可能存在的隐藏特殊字符
4. 补充认证参数：由于使用Microsoft Entra ID认证挂载，需在New-PSDrive命令中添加-Credential参数传入Entra ID凭据，或确保当前登录用户拥有共享访问权限。修正后的挂载命令示例：

New-PSDrive -Name M -PSProvider FileSystem -Root "\\your-storage-account.file.core.windows.net\u-brandonp" -Persist -Credential (Get-Credential)

运行时输入你的Entra ID用户名和密码即可。

额外检查 #

• 确认客户端PC已加入Entra ID或通过Intune注册，且当前登录用户拥有该Azure文件共享的访问权限
• 单独执行Test-NetConnection -ComputerName your-storage-account.file.core.windows.net -Port 445，验证445端口是否能正常访问，查看返回结果中TcpTestSucceeded是否为True

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