Azure Pipeline中Azure PowerShell Task的Start-Sleep命令失效问题排查

下面是几种常见的错误原因和对应的解决办法：

1. 脚本语法或参数错误 #

• 确保Start-Sleep的参数写法正确，推荐使用完整参数名避免歧义：

  # 正确写法，指定等待秒数
  Start-Sleep -Seconds 30
  # 或简写（不推荐，避免环境兼容问题）
  Start-Sleep 30
  

  不要出现拼写错误，比如把-Seconds写成-Second，这种小错误会直接导致命令失效。

2. 任务配置错误 #

• 检查Azure PowerShell任务的Script Type设置：
  • 如果选择的是「Inline Script」，直接把Start-Sleep命令写在输入框中，不要包裹多余的引号或格式符；
  • 如果选择的是「Script Path」，确保脚本文件路径配置正确，且文件内的Start-Sleep命令语法无误，任务能正常读取到脚本文件。

3. 脚本提前终止 #

• 如果Start-Sleep命令之前的脚本抛出错误，Azure Pipeline默认会终止后续脚本执行，导致Sleep命令没机会运行：
  • 可以在脚本开头添加$ErrorActionPreference = 'Continue'，让脚本即使遇到错误也继续执行；
  • 或者给容易出错的命令单独添加-ErrorAction Continue参数，比如：

    Get-AzResource -Name "NonExistentResource" -ErrorAction Continue
    Start-Sleep -Seconds 30
    

  • 查看任务的运行日志，确认Start-Sleep所在行是否被执行到，以此判断是否是前面的错误导致中断。

4. 等待时间过短或场景误解 #

• 如果设置的等待时间过短（比如1秒），可能会误以为命令没生效，建议先改成10秒以上测试；
• 如果你是想等待Azure资源操作完成，不要单纯依赖Start-Sleep，优先使用Azure命令自带的等待参数（比如az vm create --wait），这类参数会等待资源状态达标后再继续，比固定时长Sleep更可靠。

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