AzurePowerShell任务在Azure Yaml流水线中运行时找不到指定filePath路径报错

该报错的核心原因是执行PowerShell任务时无法在指定路径找到目标脚本，最常见诱因是deployment类型的作业默认不会自动拉取当前仓库源码，可按以下步骤排查解决：

• 步骤1：添加显式代码检出配置
  deployment作业的deploy阶段默认不执行源码拉取，需要在steps最开头增加checkout: self手动触发代码检出，修正后的完整配置参考：

jobs:
  - deployment: Deploy
    displayName: Deploy
    environment: $(myEnvironment)
    pool:
      vmImage: 'windows-latest'

    strategy:
      runOnce:
        deploy:
          steps:          
          # 新增：手动检出当前仓库代码
          - checkout: self
          - task: AzurePowerShell@5
            displayName: 'Run Powershell script'
            inputs:
              azureSubscription: $(azureConnectionName)
              scriptType: filePath
              scriptPath: '$(Build.SourcesDirectory)\myPowershellFile.ps1'
              azurePowerShellVersion: latestVersion

• 步骤2：验证文件实际存在性
  如果添加检出步骤后仍报错，可在PowerShell任务前新增临时验证步骤，打印源码目录下的所有文件确认路径是否匹配：

- powershell: |
    Write-Host "源码目录文件清单："
    dir $(Build.SourcesDirectory)
  displayName: 校验脚本文件是否存在

查看该步骤的运行输出，确认myPowershellFile.ps1是否在清单中：

• 如果不存在：检查脚本是否提交到了触发流水线的对应分支、是否存放在子目录中未补全路径
• 如果存在：直接复制输出中该文件的全路径替换scriptPath的配置值即可
• 步骤3：特殊场景适配
  如果流水线关联了多个仓库，将checkout: self替换为对应仓库的配置名即可；如果部署作业依赖上游构建任务的产物，需要先添加上游产物下载步骤，再指向产物内的脚本路径执行。

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