如何用Windows PowerShell发起带X509客户端证书认证的文件上传POST请求？

没问题，这事儿在PowerShell里完全能搞定，而且正好可以利用Windows自带的证书存储，不用手动处理证书解密的麻烦。我给你分版本一步步讲清楚怎么做：

PowerShell 7及以上版本的Invoke-RestMethod和Invoke-WebRequest支持-Form参数，能轻松构建multipart/form-data请求，同时直接指定客户端证书，语法非常简洁：

# 1. 从当前用户的个人证书存储中获取目标客户端证书
# 推荐用证书指纹（Thumbprint）定位，因为它是唯一的
$cert = Get-ChildItem -Path Cert:\CurrentUser\My | Where-Object {
    $_.Thumbprint -eq "你的证书指纹字符串"
} | Select-Object -First 1

# 先检查证书是否存在
if (-not $cert) {
    Write-Error "未找到指定的客户端证书，请确认指纹或证书存储路径是否正确"
    exit 1
}

# 2. 构建表单数据：包含要上传的文件，以及其他需要的表单字段（可选）
$formParams = @{
    file = Get-Item -Path "C:\你要上传的文件路径\example.pdf"
    description = "这是通过PowerShell上传的测试文件" # 可选字段，按需添加
}

# 3. 发起POST请求
try {
    $response = Invoke-RestMethod -Uri "https://你的API接口地址/upload" `
        -Method Post `
        -Certificate $cert `
        -Form $formParams `
        -Verbose # 开启Verbose可以看到请求的详细过程，方便调试
    
    Write-Host "上传成功！响应内容："
    $response | ConvertTo-Json
}
catch {
    Write-Error "请求失败：$_"
    # 若需要查看详细错误响应，可添加以下代码
    # if ($_.Exception.Response) {
    #     $errorContent = Get-Content $_.Exception.Response.GetResponseStream() -Raw
    #     Write-Error "错误详情：$errorContent"
    # }
}

如果还在使用PowerShell 5.1（Windows默认版本），因为它没有-Form参数，需要手动组装multipart/form-data的请求体，不过也能顺利实现：

# 1. 获取目标客户端证书
$cert = Get-ChildItem -Path Cert:\CurrentUser\My | Where-Object {
    $_.Thumbprint -eq "你的证书指纹字符串"
} | Select-Object -First 1

if (-not $cert) {
    Write-Error "未找到指定的客户端证书"
    exit 1
}

# 2. 生成multipart请求的边界符（确保唯一，避免和文件内容冲突）
$boundary = [System.Guid]::NewGuid().ToString()
$newline = "`r`n"

# 3. 读取要上传的文件内容
$filePath = "C:\你要上传的文件路径\example.txt"
$fileContent = [System.IO.File]::ReadAllBytes($filePath)
$fileName = [System.IO.Path]::GetFileName($filePath)

# 4. 构建multipart请求体的前缀部分
$bodyBuilder = New-Object System.Text.StringBuilder
[void]$bodyBuilder.AppendLine("--$boundary")
[void]$bodyBuilder.AppendLine("Content-Disposition: form-data; name=`"file`"; filename=`"$fileName`"")
[void]$bodyBuilder.AppendLine("Content-Type: application/octet-stream") # 根据文件类型调整，比如image/png
[void]$bodyBuilder.AppendLine()
$bodyPrefix = [System.Text.Encoding]::UTF8.GetBytes($bodyBuilder.ToString())

# 构建请求体的后缀部分
$bodySuffix = [System.Text.Encoding]::UTF8.GetBytes($newline + "--$boundary--" + $newline)

# 合并前缀、文件内容、后缀为完整的请求体字节数组
$body = New-Object byte[] ($bodyPrefix.Length + $fileContent.Length + $bodySuffix.Length)
[System.Buffer]::BlockCopy($bodyPrefix, 0, $body, 0, $bodyPrefix.Length)
[System.Buffer]::BlockCopy($fileContent, 0, $body, $bodyPrefix.Length, $fileContent.Length)
[System.Buffer]::BlockCopy($bodySuffix, 0, $body, $bodyPrefix.Length + $fileContent.Length, $bodySuffix.Length)

# 5. 发起请求
try {
    $webRequest = [System.Net.WebRequest]::Create("https://你的API接口地址/upload")
    $webRequest.Method = "POST"
    $webRequest.ClientCertificates.Add($cert) | Out-Null
    $webRequest.ContentType = "multipart/form-data; boundary=$boundary"
    $webRequest.ContentLength = $body.Length

    # 写入请求体
    $requestStream = $webRequest.GetRequestStream()
    $requestStream.Write($body, 0, $body.Length)
    $requestStream.Close()

    # 获取响应
    $response = $webRequest.GetResponse()
    $responseStream = $response.GetResponseStream()
    $reader = New-Object System.IO.StreamReader($responseStream)
    $responseContent = $reader.ReadToEnd()
    $reader.Close()
    $response.Close()

    Write-Host "上传成功！响应内容："
    $responseContent | ConvertFrom-Json | ConvertTo-Json
}
catch {
    Write-Error "请求失败：$_"
    # 查看详细错误响应
    if ($_.Exception -is [System.Net.WebException]) {
        $errorStream = $_.Exception.Response.GetResponseStream()
        $errorReader = New-Object System.IO.StreamReader($errorStream)
        $errorContent = $errorReader.ReadToEnd()
        Write-Error "错误详情：$errorContent"
    }
}

• 证书存储路径：如果证书在本地计算机存储（而非当前用户），路径改为Cert:\LocalMachine\My，但需要以管理员身份运行PowerShell才能访问。
• 证书定位：用Thumbprint（证书指纹）定位比Subject更可靠，因为同一主题的证书可能存在多个，而指纹是唯一的。你可以在证书管理器中查看证书的指纹。
• 调试技巧：请求失败时，开启-Verbose（7+）或捕获WebException查看错误响应，能帮你快速定位问题（比如证书不被服务端信任、文件路径错误等）。

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