创建/更新网站任务失败：DevOps发布提示找不到X盘驱动器

报错信息 #

Cannot find drive. A drive with the name 'X' does not exist.

任务配置 #

- task: IISWebAppManagementOnMachineGroup@0              
  inputs:
    EnableIIS: true
    WebsiteName: 
    WebsitePhysicalPath: 'X:\iis\abc.com'
    WebsitePhysicalPathAuth: WebsiteWindowsAuth
    WebsiteAuthUserName: 
    WebsiteAuthUserPassword: 
    AddBinding: true
    Bindings: '{"bindings":[{"protocol":"https","ipAddress":"All Unassigned","port":"443","hostname":"","sslThumbprint":"","sniFlag":true}]}'
    CreateOrUpdateAppPoolForWebsite: true
    ConfigureAuthenticationForWebsite: true
    AppPoolNameForWebsite: 
    AnonymousAuthenticationForWebsite: true
    WindowsAuthenticationForWebsite: false

排查步骤 #

• 检查部署代理的运行身份：DevOps部署代理默认可能用本地系统账户运行，这类账户无法访问用户手动映射的网络驱动器（X盘大概率是网络映射盘）。需将代理服务的登录账户切换为有权访问X盘的域账户/本地账户，且该账户需在目标服务器上完成过X盘的映射操作。
• 替换映射驱动器为UNC路径：映射驱动器依赖用户会话上下文，改用\\目标服务器名\共享名\iis\abc.com格式的UNC路径，彻底规避驱动器字母的上下文限制，同时确保代理运行账户拥有该共享路径的读写权限。
• 验证目标服务器上的驱动器可见性：用代理运行的账户登录目标服务器，打开PowerShell执行Get-PSDrive命令，确认X盘是否在列表中。如果看不到，说明该账户下未映射X盘，需重新映射或调整权限配置。
• 核对路径准确性：确认目标服务器上的实际路径与任务配置中的X:\iis\abc.com完全一致，排除拼写错误、特殊符号或空格问题（Windows文件系统不区分大小写，但需确保路径层级无偏差）。
• 检查权限配置：确保代理运行账户拥有X盘根目录及\iis\abc.com路径的NTFS读写权限，若X盘是网络共享，还需确认共享权限已开放给该账户。

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