求助：IIS部署PowerShell简易Web服务遇HTTP Error 502.2故障

一、先排查CGI配置的坑 #

• 检查IIS里.ps1处理器的设置：可执行路径必须是powershell.exe的完整路径，比如C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe，参数要设成-NoProfile -ExecutionPolicy Bypass -File "%s"——注意参数顺序不能乱，-File必须在最后，%s是脚本路径的占位符，别写错。
• 权限要给够：IIS应用池的身份（比如默认的ApplicationPoolIdentity）得有执行powershell.exe的权限，还要能读取你的脚本文件。直接给应用池身份添加脚本所在文件夹的「读取&执行」权限试试。
• 执行策略别卡壳：在服务器上开管理员PowerShell，跑Get-ExecutionPolicy看看，如果是Restricted，赶紧用Set-ExecutionPolicy RemoteSigned改成允许本地脚本执行。

二、脚本输出必须严格合规 #

别以为加了Content-Type就没事，很多时候是输出格式不对：

• 脚本开头必须先输出HTTP头，然后空一行，再输出内容，比如：

# 先输出头，空行分隔是关键
Write-Output "Content-Type: application/json"
Write-Output ""
# 再输出JSON
$response = @{
    Status = "Success"
    Message = "PowerShell Web Service works"
} | ConvertTo-Json
Write-Output $response

• 别输出无关内容：绝对不能用Write-Host（这货输出到控制台，不会进HTTP响应），也别让脚本抛出未捕获的错误——开头加个$ErrorActionPreference = "Stop"，或者用try/catch把逻辑包起来，防止错误信息混进响应头里。
• 先单独跑脚本测试：直接在服务器上执行你的脚本，看输出是不是严格的「头+空行+内容」格式，比如输出应该是：

Content-Type: application/json

{"Status":"Success","Message":"PowerShell Web Service works"}

三、别死磕CGI，换更靠谱的方案 #

用CGI托管PowerShell脚本本来就不稳定，推荐两种更省心的方式：

1. PowerShell Universal #

这是专门用来托管PowerShell脚本、API的工具，支持IIS部署，自带Web管理界面、路由配置、身份验证，完全不用手动折腾CGI。安装后直接创建API端点绑定脚本就行，还自带日志和调试工具，比CGI好用太多。

2. ASP.NET Core + PowerShell #

如果懂点.NET，用ASP.NET Core写个Web API，在接口里调用PowerShell脚本，稳定性拉满：

• 创建ASP.NET Core Web API项目，安装Microsoft.PowerShell.SDK NuGet包。
• 控制器里的示例代码：

[ApiController]
[Route("api/powershell")]
public class PowerShellController : ControllerBase
{
    [HttpGet]
    public async Task<IActionResult> Get()
    {
        using var ps = PowerShell.Create();
        ps.AddScript(@"
            $response = @{
                Status = ""Success""
                Message = ""Hello from ASP.NET Core + PowerShell""
            } | ConvertTo-Json
            return $response
        ");
        var result = await ps.InvokeAsync();
        if (ps.HadErrors)
        {
            return BadRequest(ps.Streams.Error.Select(e => e.ToString()));
        }
        return Ok(result[0].ToString());
    }
}

这种方式能完美集成IIS的SSL、负载均衡等功能，出问题也好排查。

四、调试小技巧 #

• 开CGI日志：在IIS管理器里找到网站的日志功能，启用CGI日志，能看到脚本执行的返回码、输出内容，方便定位问题。
• 用Process Monitor跟踪：过滤powershell.exe进程，看看是不是有文件访问权限问题，或者脚本执行时的异常。

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