Azure托管构建代理上azcopy调用失败问题求助

问题回顾 #

原本依赖AzureFileCopy任务向VM传输文件，因该任务最新版本存在URL与SAS令牌间缺失?的Bug，临时改为两步方案：先传文件到存储账户，再通过AzCopy从Blob复制到VM。但近期在「目标机器上的PowerShell」任务中直接调用AzCopy时，出现报错：

azcopy : The term 'azcopy' is not recognized as the name of a cmdlet, function, script file, or operable program.

已尝试过搜索代理上的AzCopy、更换代理版本、安装Az模块、手动下载解压AzCopy、将AzCopy作为工件下载等操作，均未解决。

可行解决方案 #

方案1：在目标VM上预安装AzCopy并配置环境变量 #

在目标VM的PowerShell脚本中先完成AzCopy的安装与环境变量配置，再执行复制命令：

# 下载AzCopy压缩包
Invoke-WebRequest -Uri "https://aka.ms/downloadazcopy-v10-windows" -OutFile "AzCopy.zip" -UseBasicParsing

# 解压到指定目录
Expand-Archive -Path "AzCopy.zip" -DestinationPath "C:\AzCopy" -Force

# 将AzCopy路径添加到当前会话的环境变量
$azcopyDir = Get-ChildItem -Path "C:\AzCopy" -Name "azcopy_windows_amd64_*" | Select-Object -First 1
$env:Path += ";C:\AzCopy\$azcopyDir"

# 验证AzCopy可用性
azcopy --version

# 执行Blob到VM的复制命令
azcopy copy "<Blob SAS URL>" "<本地目标路径>"

方案2：使用Azure DevOps官方「AzCopy Copy」任务替代手动调用 #

放弃PowerShell内联脚本，改用官方任务自动处理AzCopy环境配置：

1. 在发布管道中添加「AzCopy Copy」任务
2. 配置源类型为Azure Blob，填写存储账户、容器信息及SAS令牌
3. 配置目标类型为Local Files，填写VM上的目标路径
4. 复用原PowerShell任务的「目标机器连接」配置

方案3：直接使用AzCopy完整路径调用 #

若已将AzCopy下载到VM固定路径，跳过环境变量配置，直接用完整路径执行：

# 假设AzCopy解压到C:\Tools\AzCopy
C:\Tools\AzCopy\azcopy.exe copy "<Blob SAS URL>" "<本地目标路径>"

方案4：修复Az模块的非交互式安装问题 #

调整安装命令参数，绕过非交互式环境的确认提示：

# 临时设置执行策略
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

# 安装Az模块（强制跳过确认与发布者检查）
Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Confirm:$False -Force -AllowClobber -SkipPublisherCheck

# 导入模块并调用AzCopy
Import-Module Az.Storage
$azcopyPath = (Get-AzCopyPath).Path
& $azcopyPath copy "<Blob SAS URL>" "<本地目标路径>"

关键注意事项 #

• 确保目标VM上的脚本有足够权限写入目录、修改环境变量
• 下载AzCopy时优先使用官方稳定版链接，避免版本兼容问题
• 检查VM杀毒软件或防火墙是否拦截了AzCopy的执行

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