7Zip4Powershell在Azure DevOps代理中执行压缩命令失败求助

在Azure DevOps流水线中安装7Zip4Powershell模块以实现带密码的文件压缩，安装命令如下：

Install-Module -Name 7Zip4Powershell -Repository PSGallery -Force

执行压缩命令时，指定路径未生成压缩包，报错如下：

System.IO.FileNotFoundException: Could not find file
'/agent/_work/1/s/Runbook/Scripts/stblog_20240415_SAS.zip'. File
name: '/agent/_work/1/s/Runbook/Scripts/stblog_20240415_SAS.zip'
at Interop.ThrowExceptionForIoErrno(ErrorInfo errorInfo, String path,
Boolean isDirError) at

• 验证目标目录的存在性与权限
  压缩命令执行前，先确认目标目录存在且流水线代理有写入权限，添加调试输出排查路径问题：

  # 确保目标目录存在，不存在则创建
  if (-not (Test-Path $scriptPath)) {
      New-Item -ItemType Directory -Path $scriptPath -Force
  }
  # 输出变量值用于调试
  Write-Host "当前工作目录: $(Get-Location)"
  Write-Host "scriptPath: $scriptPath"
  Write-Host "目标压缩文件路径: $scriptPath\$SASUri_FileName.zip"
  

• 确认源文件路径有效性
  若$SASUri_FilePath是云存储的SAS URI，7Zip4Powershell不支持直接压缩远程文件，需先下载到代理本地目录；若为本地路径，先验证文件是否存在：

  if (-not (Test-Path $SASUri_FilePath)) {
      throw "源文件不存在，请检查路径: $SASUri_FilePath"
  }
  

• 确保模块正确安装并加载
  流水线环境中需显式导入模块，添加-Scope CurrentUser避免权限问题：

  Install-Module -Name 7Zip4Powershell -Repository PSGallery -Force -Scope CurrentUser
  Import-Module 7Zip4Powershell -Force
  # 验证模块加载状态
  Get-Module 7Zip4Powershell
  

• 修正压缩命令的参数匹配
  避免格式与文件名后缀不匹配的问题，若生成zip文件，使用-Format Zip参数；同时用Join-Path构建可靠的绝对路径：

  $archivePath = Join-Path -Path $scriptPath -ChildPath "$SASUri_FileName.zip"
  Compress-7Zip -Path $SASUri_FilePath -ArchiveFileName $archivePath -Format Zip -Password $key -Verbose
  

• 捕获详细错误信息
  添加异常捕获，获取更完整的错误堆栈，帮助定位问题：

  try {
      $archivePath = Join-Path -Path $scriptPath -ChildPath "$SASUri_FileName.zip"
      Compress-7Zip -Path $SASUri_FilePath -ArchiveFileName $archivePath -Format Zip -Password $key -Verbose
  } catch {
      Write-Host "压缩失败详细信息: $_"
      Write-Host "错误堆栈: $($_.ScriptStackTrace)"
  }
  

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