Microsoft Azure Pipelines Tasks 中 PowerShell 脚本执行失败的排查与解决

问题现象

在使用 Microsoft Azure Pipelines Tasks 执行 PowerShell 脚本时，用户遇到了一个关于 Dynamics 365 Business Central 管理模块的错误。具体表现为：

1. 脚本在本地 PowerShell ISE 中可以正常执行
2. 在 Azure Pipelines 中运行时失败
3. 错误信息为："Get-NAVServerInstance : The system cannot find the file specified"

问题分析

环境差异

从日志中可以看出，问题发生在 Business Central 2024 wave 1 版本环境中，而在 2023 wave 2 版本中相同脚本可以正常工作。这表明问题可能与版本升级带来的变化有关。

错误根源

错误信息显示系统找不到指定文件，这通常意味着：

1. 模块路径不正确
2. 执行权限不足
3. 32位/64位环境不匹配
4. PowerShell 版本兼容性问题

关键发现

1. 脚本成功加载了 NavAdminTool.ps1 模块（日志中显示了欢迎信息）
2. 但在调用 Get-NAVServerInstance 时失败
3. 本地执行正常，说明模块本身没有问题

解决方案

使用 PowerShell Core

问题的根本原因是 Azure Pipelines 默认使用 Windows PowerShell（5.1版本），而 Business Central 2024 可能需要 PowerShell Core（7.x版本）才能正常工作。

解决方法：

1. 在 PowerShell 任务中启用 "Use PowerShell Core" 选项
2. 或者显式指定使用 pwsh.exe 而不是 powershell.exe

配置建议

对于 Dynamics 365 Business Central 相关任务，建议：

1. 明确指定 PowerShell 版本
2. 检查模块加载路径是否正确
3. 验证执行账户权限
4. 考虑32位/64位兼容性

最佳实践

1. 环境一致性：确保开发、测试和生产环境使用相同的 PowerShell 版本
2. 显式声明：在脚本中明确指定模块路径和版本要求
3. 错误处理：添加详细的错误捕获和处理逻辑
4. 日志记录：增加调试信息输出，便于问题排查

总结

在 Azure Pipelines 中执行 PowerShell 脚本时，特别是涉及 Dynamics 365 Business Central 管理任务时，PowerShell 版本的选择至关重要。新版本的 Business Central 可能需要 PowerShell Core 才能正常工作。通过合理配置任务参数和使用正确的 PowerShell 版本，可以避免此类兼容性问题。