Azure发布管道更新本地现有IIS虚拟目录报错，无需删除如何解决？

问题概述 #

使用Azure发布管道的IIS Web App Manage步骤配置IIS虚拟目录时，若目标虚拟目录已存在，会抛出以下错误：

2023-02-02T21:54:06.4773028Z ERROR ( message:Must use exact identifer for VDIR object with verb SET. )
2023-02-02T21:54:06.6837602Z ##[error]Process 'appcmd.exe' exited with code '50'

删除已存在的虚拟目录后步骤可正常执行，但希望无需手动/自动删除即可完成部署。

解决方案 #

方案1：改用PowerShell脚本实现“创建或更新”逻辑 #

原生IIS Web App Manage任务的虚拟目录创建操作不支持覆盖已存在资源，可通过PowerShell脚本直接操作IIS，实现条件化的创建或更新：

1. 在Azure发布管道中添加一个PowerShell任务（替代原有的IIS Web App Manage步骤）
2. 将以下脚本填入任务的“脚本内容”区域，替换对应的参数值：

# 配置参数
$parentSite = "Default Web Site"
$virtualDirName = "virtual directory name" # 注意：这里是虚拟目录的名称，不含开头的/
$physicalPath = "磁盘中的文件位置"

# 检查虚拟目录是否存在
$existingVDir = Get-WebVirtualDirectory -Site $parentSite -Name $virtualDirName

if ($existingVDir) {
    # 已存在则更新物理路径
    Set-WebVirtualDirectory -Site $parentSite -Name $virtualDirName -PhysicalPath $physicalPath
    Write-Host "已更新虚拟目录 $parentSite/$virtualDirName 的物理路径为 $physicalPath"
}
else {
    # 不存在则创建新的虚拟目录
    New-WebVirtualDirectory -Site $parentSite -Name $virtualDirName -PhysicalPath $physicalPath
    Write-Host "已创建虚拟目录 $parentSite/$virtualDirName"
}

该脚本会先检查目标虚拟目录是否存在，存在则更新物理路径，不存在则创建新目录，无需删除原有资源。

方案2：修正IIS Web App Manage任务的参数格式 #

若偏好使用原生任务，可尝试调整参数格式解决标识符错误：

• 确保Virtual Path的输入不含多余空格，格式为/[虚拟目录名称]（例如/virtualDirectoryName，避免空格或特殊字符）
• 若必须使用含空格的名称，可在虚拟路径前后添加引号（例如"/virtual directory name"），确保appcmd.exe能正确解析完整的虚拟目录标识符

方案3：使用appcmd命令直接执行 #

在管道中添加命令行任务，直接调用appcmd.exe执行条件化操作：

@echo off
set "siteName=Default Web Site"
set "vdirName=virtual directory name"
set "physicalPath=磁盘中的文件位置"

:: 检查虚拟目录是否存在
%windir%\system32\inetsrv\appcmd list vdir "%siteName%/%vdirName%"
if %errorlevel% equ 0 (
    :: 存在则更新
    %windir%\system32\inetsrv\appcmd set vdir "%siteName%/%vdirName%" -physicalPath:"%physicalPath%"
) else (
    :: 不存在则创建
    %windir%\system32\inetsrv\appcmd add vdir /app.name:"%siteName%/" /path:"/%vdirName%" /physicalPath:"%physicalPath%"
)

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