已安装WebAdministration模块仍遇IIS驱动器不存在错误求助

问题描述 #

已安装web-scripting-tools组件，执行Import-Module WebAdministration提示模块导入成功，但执行Test-Path IIS:返回False，运行相关脚本时输出：

WebAdministration module successfully imported.

IIS drive 'IIS:' is not available. Ensure WebAdministration module is correctly installed.

执行Get-ChildItem IIS:SSLBindings时直接报错：Cannot find drive. A drive with the name 'IIS' does not exist.

解决步骤 #

1. 确认IIS管理控制台已安装 #

WebAdministration模块依赖IIS核心管理组件，仅安装web-scripting-tools不够：

• 打开「控制面板 > 程序 > 启用或关闭Windows功能」
• 展开「Internet Information Services > Web管理工具」，确保「IIS管理控制台」已勾选并完成安装，安装后重启PowerShell。

2. 以管理员身份运行PowerShell #

普通权限下，WebAdministration模块可能无法创建IIS:虚拟驱动器。右键PowerShell选择「以管理员身份运行」，再重新执行脚本。

3. 手动注册IIS驱动器 #

如果导入模块后仍未自动创建IIS驱动器，可手动执行以下命令：

Import-Module WebAdministration
New-PSDrive -Name IIS -PSProvider WebAdministration -Root IIS:\

执行后用Test-Path IIS:验证，返回True则说明驱动器已创建成功。

4. 切换至IISAdministration模块（推荐方案） #

WebAdministration是较旧的模块，微软官方推荐使用更新的IISAdministration模块，该模块不依赖IIS:虚拟驱动器，兼容性更好：

1. 安装模块（需管理员权限）：

Install-Module IISAdministration -Force

2. 修改原脚本逻辑，替换为IISAdministration的API，示例修改后的核心函数：

function Get-SiteSslCertificate {
    param (
        [int]$SiteId
    )

    Import-Module IISAdministration -Force

    $site = Get-IISSite | Where-Object { $_.Id -eq $SiteId }
    if (-not $site) {
        Write-Host "Site with ID $SiteId not found." -ForegroundColor Red
        return
    }

    Write-Host "Retrieving SSL bindings for site '$($site.Name)' (ID: $SiteId)" -ForegroundColor White

    # 获取站点的所有HTTPS绑定
    $sslBindings = $site.Bindings.Collection | Where-Object { $_.Protocol -eq 'https' }

    if (-not $sslBindings) {
        Write-Host "No SSL bindings found for site '$($site.Name)' (ID: $SiteId)" -ForegroundColor Red
        return
    }

    foreach ($binding in $sslBindings) {
        Write-Host "`nSSL Binding: $($binding.BindingInformation)" -ForegroundColor Yellow
        # 提取证书指纹并格式化
        $certHash = $binding.Attributes['certificateHash'].Value
        $thumbprint = [System.BitConverter]::ToString($certHash).Replace('-', '')
        Write-Host "Certificate Thumbprint: $thumbprint" -ForegroundColor Yellow
        
        # 从证书存储获取详情
        $certificate = Get-ChildItem -Path Cert:\LocalMachine\My | Where-Object { $_.Thumbprint -eq $thumbprint }
        
        if ($certificate) {
            Write-Host "`nCertificate Details:" -ForegroundColor Cyan
            Write-Host "Subject: $($certificate.Subject)" -ForegroundColor Cyan
            Write-Host "Issuer: $($certificate.Issuer)" -ForegroundColor Cyan
            Write-Host "Thumbprint: $($certificate.Thumbprint)" -ForegroundColor Cyan
            Write-Host "Expiration Date: $($certificate.NotAfter)" -ForegroundColor Cyan
        } else {
            Write-Host "Certificate with thumbprint $thumbprint not found in the local machine store." -ForegroundColor Red
        }
    }
}

5. 检查PowerShell版本兼容性 #

确保使用PowerShell 5.1及以上版本（Windows Server 2012及以上系统默认自带），旧版本可能存在模块加载异常。可通过$PSVersionTable.PSVersion查看版本。

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