使用PowerShell停止IIS应用池时出现模块未找到错误求助

以管理员身份运行PowerShell，编写了Restart_webAppPool函数用于重启指定的3个IIS应用池。目前可以正常列出目标应用池，但执行停止或重启操作时触发报错，提示指定模块未找到。

函数代码 #

function Restart_webAppPool(){
$ArrayIIS = @(Get-IISAppPool -Name NAME1, NAME2, NAME3)

Import-Module WebAdministration 

foreach($process in $ArrayIIS ){

Stop-WebAppPool $process.Name

}
}

执行错误信息 #

Exception calling "Stop" with "0" argument(s): "The specified module could not be found. (Exception from HRESULT:0x8007007E)"
At C:\script\script.ps1:104 char:1

• (Get-IISAppPool("NaME1")).stop()
  • CategoryInfo : NotSpecified: (:) [], MethodInvocationException
  • FullyQualifiedErrorId : FileNotFoundException

问题分析 #

这个错误核心原因是模块加载时机错误和IIS管理模块混用冲突：

1. 代码中先调用Get-IISAppPool（属于IISAdministration模块），之后才导入WebAdministration模块，导致执行停止操作时依赖的组件未提前加载；
2. Get-IISAppPool和Stop-WebAppPool分属两个不同的IIS管理模块，混用容易引发兼容性问题。

解决方案 #

方案1：提前加载所有依赖模块 #

将模块导入语句放在函数最开头，确保执行任何IIS操作前，所需模块已完成加载：

function Restart_webAppPool(){
    # 优先导入所有依赖模块
    Import-Module WebAdministration
    Import-Module IISAdministration

    $ArrayIIS = @(Get-IISAppPool -Name NAME1, NAME2, NAME3)

    foreach($process in $ArrayIIS ){
        Stop-WebAppPool -Name $process.Name
        # 可选：等待停止完成后启动应用池
        Start-WebAppPool -Name $process.Name
    }
}

方案2：统一使用IISAdministration模块 #

Windows Server 2016及以上版本推荐使用IISAdministration模块（更稳定的新一代IIS管理模块），直接通过对象方法操作：

function Restart_webAppPool(){
    Import-Module IISAdministration

    $ArrayIIS = @(Get-IISAppPool -Name NAME1, NAME2, NAME3)

    foreach($pool in $ArrayIIS ){
        $pool.Stop()
        # 循环等待应用池完全停止
        do {
            Start-Sleep -Milliseconds 500
            $pool.Refresh()
        } while ($pool.State -ne 'Stopped')
        
        $pool.Start()
    }
}

额外检查项 #

• 确保PowerShell以管理员身份运行（右键选择「以管理员身份运行」）；
• 确认服务器已安装IIS Management Scripts and Tools组件（在服务器管理器的IIS角色功能中添加）；
• 避免在同一脚本中混用WebAdministration和IISAdministration模块的命令。

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