appcmd

IIS 7+ 命令行管理工具，批量管理站点、应用池和配置。

补充说明

appcmd.exe 位于 %windir%\system32\inetsrv\，可列出、创建、修改、删除站点、应用、应用池和配置节。它直接读写 applicationHost.config，适合脚本化和批量运维。

前提是安装“Web 服务器 (IIS)”角色，并以管理员身份运行；IIS Express 不使用完整 IIS 配置，不能用它管理。修改配置前应先用 appcmd add backup 生成配置备份，删除站点前要确认物理目录和绑定关系。

Windows Server 2016+（IIS 10）命令基本一致。PowerShell 的 WebAdministration 模块提供 Get-IISSite、New-WebAppPool 等对象化 cmdlet，复杂逻辑更易读；appcmd 在 CMD 脚本中仍很高效。

常用示例

# 列出所有站点及状态、绑定
C:\> %windir%\system32\inetsrv\appcmd.exe list sites

# 列出应用池及运行状态
C:\> %windir%\system32\inetsrv\appcmd.exe list apppool

# 列出正在运行的工作进程，确认请求落到哪个 w3wp
C:\> %windir%\system32\inetsrv\appcmd.exe list wp

# 影响范围：回收指定应用池，池内应用短暂中断，其他池不受影响
# 备份/回滚：配置不变，无需回滚；异常时再次 recycle 或检查应用日志
C:\> %windir%\system32\inetsrv\appcmd.exe recycle apppool "DefaultAppPool"

# 影响范围：写入站点配置并立即生效，绑定冲突会导致启动失败
# 备份/回滚：先 appcmd add backup；回滚用 restore backup 或删除该站点
C:\> %windir%\system32\inetsrv\appcmd.exe add site /name:"Portal" /bindings:"http/*:8080:" /physicalPath:"D:\Sites\Portal"

# 影响范围：删除站点配置后站点立即下线，但不会删除物理文件
# 备份/回滚：先 appcmd add backup "before-delete"；回滚用 restore backup 恢复配置
C:\> %windir%\system32\inetsrv\appcmd.exe delete site "Portal"

# 修改前备份 applicationHost.config
C:\> %windir%\system32\inetsrv\appcmd.exe add backup "before-portal-change"

易错点与排错

• 提示“不是内部或外部命令” → inetsrv 不在 PATH 中 → 使用完整路径，或在脚本里先 set PATH=%PATH%;%windir%\system32\inetsrv。
• 拒绝访问 → 未以管理员运行，或配置文件被共享配置锁定 → 提升权限，并确认是否使用集中式配置。
• 添加站点成功但访问 404 → physicalPath 不存在、权限不足或默认文档缺失 → 检查目录 ACL 与站点物理路径。
• 绑定冲突导致站点启动失败 → 同一 IP/端口/主机头已被占用 → 用 appcmd list sites 检查绑定，必要时改用不同端口或主机头。
• 删除站点后文件还在 → delete site 只删配置，不删磁盘内容 → 需要清理目录时另行确认并备份。
• restore backup 后配置回退但服务异常 → 恢复会重载配置，应用池可能重启 → 在变更窗口执行，并验证站点与绑定。

相关命令

• iisreset — 整体重启 IIS，用于配置或服务异常
• sc — 检查 W3SVC 与应用池依赖服务
• netstat — 验证站点监听端口
• tasklist — 查看 w3wp 进程与 PID
• icacls — 修复站点目录权限

参考链接

• Microsoft Learn: Getting Started with AppCmd.exe
• Microsoft Learn: WebAdministration module

读完自测

1. appcmd 依赖什么角色，为什么必须用完整路径？
2. 修改配置前应如何备份和回滚？
3. delete site 会删除站点文件吗？