Azure Pipelines将Azure文件共享映射至部署组VM失败问题排查

使用Azure DevOps发布管道，尝试将Azure文件共享映射到部署组内所有VM。已将Azure门户提供的本地映射脚本中的密钥替换为管道变量，且确认变量可正常读取。执行脚本后输出显示驱动器号已创建，但打开文件资源管理器时该驱动器显示“已断开连接”，无法访问，提示“此网络连接不存在”，实际未完成映射。本地直接运行该脚本可成功映射，需排查管道或脚本中的问题。

执行脚本 #

cmd.exe /C "cmdkey /add:`"storageaccount.file.core.windows.net`" /user:`"localhost\storageaccount`" /pass:`"accesskeyforstorageaccount`"
New-PSDrive -Name Z -PSProvider Filesystem -Root "\\storageaccount.file.core.windows.net\\fileshare-name" -Persist

• 检查脚本执行账户上下文：Azure DevOps部署组代理默认以本地系统账户运行，本地测试用的是当前登录用户账户。本地系统账户创建的网络映射不会显示在普通用户的文件资源管理器中，需切换到代理运行的账户上下文查看，或配置代理以交互用户身份运行（注意权限风险）。
• 验证凭据是否成功添加：在脚本中追加cmdkey /list命令，输出凭据列表，确认存储账户的凭据已被正确添加到代理账户的凭据管理器中。
• 确认驱动器实际状态：在New-PSDrive命令后添加Get-PSDrive Z，输出驱动器的详细状态，判断是否真的创建成功，而非仅返回表面的成功提示。
• 修正路径转义问题：脚本中路径的双反斜杠可能存在转义冲突，尝试将Root参数改为"\\storageaccount.file.core.windows.net\fileshare-name"（单反斜杠结尾），或用单引号包裹路径避免转义。
• 添加强制错误捕获：修改脚本加入错误处理逻辑，确保凭据添加失败时直接终止并报错，避免后续命令继续执行：

  $ErrorActionPreference = "Stop"
  cmd.exe /C "cmdkey /add:`"storageaccount.file.core.windows.net`" /user:`"localhost\storageaccount`" /pass:`"accesskeyforstorageaccount`""
  if ($LASTEXITCODE -ne 0) { throw "添加凭据失败，退出码：$LASTEXITCODE" }
  New-PSDrive -Name Z -PSProvider Filesystem -Root "\\storageaccount.file.core.windows.net\fileshare-name" -Persist
  Get-PSDrive Z
  

• 检查网络端口连通性：在部署组VM上手动执行ping storageaccount.file.core.windows.net，并测试445端口是否开放（Azure文件共享依赖445端口），部分环境可能因防火墙限制导致映射失败。

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