PowerShell wget 命令：替代 curl 的下载利器 – wiki基地

作者： /

PowerShell 中的下载利器：深入解析 Invoke-WebRequest (以及它的别名 wget)

在信息技术领域，与互联网进行交互是日常工作中不可或缺的一部分。无论是下载文件、与 Web API 通信、自动化网页操作，还是进行简单的连接测试，一个强大、灵活的命令行工具都能极大地提升效率。对于 Linux 和 macOS 用户来说，curl 和 wget 是这类任务中的佼佼者，它们功能强大，久负盛名。

然而，对于 Windows 用户，尤其是那些经常使用 PowerShell 进行系统管理和自动化任务的用户来说，Windows 原生提供的工具是什么呢？虽然最新版本的 Windows 10/11 和 PowerShell Core 可以轻松安装 curl 或 wget，但 PowerShell 其实自带了一个同样强大且与环境深度集成的 Web 请求 cmdlet：Invoke-WebRequest。更令人惊喜的是，为了方便那些习惯了 Linux/Unix 环境的用户，PowerShell 默认就为 Invoke-WebRequest 设置了 wget 和 curl 这两个别名。

本文将详细探讨 Invoke-WebRequest (为了方便，下文有时会直接使用其别名 wget 或 curl 指代) 的功能、用法、优势以及它如何成为 Windows 环境下媲美甚至超越 curl 和 wget 的下载及 Web 交互利器。

1. 什么是 Invoke-WebRequest？

Invoke-WebRequest 是 PowerShell 中一个核心的 Cmdlet (Command-let)，它位于 Microsoft.PowerShell.Utility 模块中。它的主要作用是向指定的 Uniform Resource Identifier (URI) 发送 HTTP 或 HTTPS 请求。与传统的 curl 或 wget 工具主要用于获取原始数据不同，Invoke-WebRequest 在接收到 HTTP 响应后，会尝试解析其内容，特别是 HTML 页面。

当 Invoke-WebRequest 获取到一个网页时，它会解析 HTML 结构，并将页面中的链接 (links)、表单 (forms)、图片 (images) 等元素作为结构化对象返回。这意味着你可以不仅仅是获取页面的原始文本，还能方便地通过编程方式访问页面上的特定元素，这对于 Web 自动化、数据抓取（Web Scraping）等任务非常有用。当然，如果请求的是非 HTML 内容（如 JSON、XML、文件等），它也会将原始内容或尝试解析后的对象返回。

2. Invoke-WebRequest 的别名：wget 和 curl

为了让熟悉 Linux/Unix 命令的用户更容易上手 PowerShell，微软特意为 Invoke-WebRequest 创建了两个别名：wget 和 curl。

这意味着在 PowerShell 中，当你输入 wget https://example.com 或 curl https://example.com 时，实际上执行的命令是 Invoke-WebRequest -Uri https://example.com。这个设计大大降低了跨平台用户的学习成本。

重要提示: 尽管有这些别名，但 Invoke-WebRequest 的参数和行为是符合 PowerShell 规范的，与原生 curl 或 wget 的命令行参数 不完全相同。如果你需要使用原生 curl 的所有高级功能或其完全相同的参数语法，你可能仍然需要安装原生的 curl 工具（例如通过 Scoop, Chocolatey 或 Windows Subsystem for Linux – WSL）。但对于大多数常见的 Web 交互任务，Invoke-WebRequest 提供的功能已经足够强大。

3. Invoke-WebRequest 的核心功能与基本用法

Invoke-WebRequest 的基本语法非常直观：

powershell
Invoke-WebRequest -Uri <要请求的URI> [可选参数]

或者使用别名：

powershell
wget <要请求的URI> [可选参数]
curl <要请求的URI> [可选参数]

下面是一些核心功能的详细介绍及示例：

3.1 发送 GET 请求和查看响应

这是最基本、最常用的功能，用于获取指定 URI 的内容。

“`powershell

发送 GET 请求并输出结果

Invoke-WebRequest -Uri “https://www.example.com”

使用别名

wget “https://www.example.com”
“`

执行上述命令后，Invoke-WebRequest 会返回一个包含丰富信息的对象 (HtmlWebResponseObject 或 BasicHtmlWebResponseObject)。这个对象包含了响应的各个方面：

  • .StatusCode: HTTP 状态码 (例如 200, 404, 500)。
  • .StatusDescription: 状态码的描述。
  • .Content: 响应的主体内容，通常是 HTML 字符串、JSON 字符串等。
  • .Headers: 响应头，一个键值对的集合。
  • .ParsedHtml: 如果内容是 HTML，这是一个可用于遍历和操作 HTML 元素的对象。
  • .Forms: 如果内容是 HTML，包含页面上的表单信息。
  • .Links: 如果内容是 HTML，包含页面上的链接信息。
  • .Images: 如果内容是 HTML，包含页面上的图片信息。

你可以通过点操作符访问这些属性：

“`powershell
$response = Invoke-WebRequest -Uri “https://www.example.com”

查看状态码

$response.StatusCode

查看响应头

$response.Headers

查看页面内容

$response.Content

查看页面上的所有链接 (如果内容是HTML)

$response.Links
“`

3.2 下载文件 (-OutFile)

这是 Invoke-WebRequest 作为 wget 和 curl 替代品最核心的功能之一。使用 -OutFile 参数可以将响应内容直接保存到本地文件。

“`powershell

下载一个文件到指定路径

Invoke-WebRequest -Uri “https://example.com/path/to/your/file.zip” -OutFile “C:\Temp\downloaded_file.zip”

下载一个网页到本地HTML文件

Invoke-WebRequest -Uri “https://www.example.com” -OutFile “C:\Temp\example.html”
“`

使用 -OutFile 参数时，Invoke-WebRequest 会自动处理文件流的写入，这比先获取内容到内存再写入文件更有效率，尤其对于大文件。

注意: 如果目标文件已经存在，-OutFile 默认会覆盖它。如果你需要避免覆盖或实现其他行为，可能需要先检查文件是否存在或使用其他逻辑。

3.3 发送不同 HTTP 方法的请求 (-Method)

Invoke-WebRequest 不仅限于 GET 请求，它支持多种 HTTP 方法，包括 POST、PUT、DELETE、HEAD、OPTIONS 等。使用 -Method 参数指定请求类型。

“`powershell

发送 HEAD 请求，只获取响应头，不下载内容

Invoke-WebRequest -Uri “https://www.example.com” -Method HEAD
“`

3.4 发送 POST 请求 (-Method POST, -Body, -ContentType)

POST 请求常用于向服务器提交数据，例如表单提交或发送 API 请求体。你需要使用 -Method POST，并通过 -Body 参数指定要发送的数据。-ContentType 参数用于指定请求体的数据类型（例如 application/x-www-form-urlencoded 用于表单数据，application/json 用于 JSON 数据）。

  • 发送表单数据:

    “`powershell

    模拟提交一个简单的HTML表单

    $formData = @{
    username = “myuser”
    password = “mypassword”
    rememberMe = “on”
    }

    Invoke-WebRequest -Uri “https://www.example.com/login” -Method POST -Body $formData -ContentType “application/x-www-form-urlencoded”
    ``
    当    -Body是一个哈希表 (@{…}) 且-ContentType是application/x-www-form-urlencoded时，PowerShell 会自动将哈希表转换为key1=value1&key2=value2` 格式。

  • 发送 JSON 数据:

    “`powershell

    发送一个JSON请求体

    $jsonData = @{
    name = “Test Item”
    value = 123
    } | ConvertTo-Json # 将PowerShell对象转换为JSON字符串

    Invoke-WebRequest -Uri “https://api.example.com/items” -Method POST -Body $jsonData -ContentType “application/json” -Headers @{“Authorization” = “Bearer your_token”} # 可能还需要设置其他头，比如认证头
    ``
    这里    -Body是一个 JSON 字符串，我们手动设置了-ContentType为application/json。同时示例中展示了如何通过-Headers` 参数添加自定义请求头。

3.5 设置请求头 (-Headers)

自定义请求头非常有用，例如设置 User-Agent 来模拟浏览器、添加认证信息 (Authorization)、指定接受的数据类型 (Accept) 等。-Headers 参数接受一个哈希表，其中键是头名称，值是头的值。

“`powershell

设置自定义User-Agent模拟浏览器访问

$headers = @{
“User-Agent” = “Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36”
“Accept” = “text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,/;q=0.8,application/signed-exchange;v=b3;q=0.9″
}

Invoke-WebRequest -Uri “https://www.example.com” -Headers $headers
“`

3.6 处理 Cookie 和会话 (-SessionVariable, -WebSession)

对于需要登录或维护状态的网站，管理 Cookie 是关键。Invoke-WebRequest 提供了 -SessionVariable 和 -WebSession 参数来处理会话。

  • 使用 -SessionVariable 创建一个新的会话并在后续请求中使用：

    “`powershell

    1. 登录网站（假设登录请求会返回包含认证信息的Cookie）

    $loginUrl = “https://www.example.com/login”
    $loginData = @{
    username = “myuser”
    password = “mypassword”
    }

    发送登录请求，并将返回的会话信息保存到 $session 变量中

    Invoke-WebRequest -Uri $loginUrl -Method POST -Body $loginData -ContentType “application/x-www-form-urlencoded” -SessionVariable session

    2. 使用同一个会话访问需要认证的页面

    $protectedPageUrl = “https://www.example.com/dashboard”

    使用之前保存的会话变量 $session 进行请求

    Invoke-WebRequest -Uri $protectedPageUrl -WebSession $session
    ``-SessionVariable session参数会创建一个Microsoft.PowerShell.Commands.WebRequestSession对象，并将其存储在名为$session的变量中。这个对象会自动管理 Cookie 和其他会话相关的信息。后续的Invoke-WebRequest调用中使用-WebSession $session` 参数即可沿用这个会话的状态。

  • 手动创建和管理 WebSession 对象：

    “`powershell

    创建一个新的会话对象

    $mySession = New-Object Microsoft.PowerShell.Commands.WebRequestSession

    设置会话的User-Agent等属性

    $mySession.UserAgent = “Custom PowerShell Session Agent”

    使用会话对象进行请求

    Invoke-WebRequest -Uri “https://www.example.com” -WebSession $mySession

    再次使用同一个会话对象进行请求，Cookie等信息会保留

    Invoke-WebRequest -Uri “https://www.example.com/another_page” -WebSession $mySession
    ``
    手动创建    WebSession对象提供了更多的灵活性，你可以检查和修改会话对象的属性，如 Cookie 集合 ($mySession.Cookies`)。

3.7 处理重定向 (-MaximumRedirection)

默认情况下，Invoke-WebRequest 会自动跟踪 HTTP 重定向（如 301, 302）。-MaximumRedirection 参数允许你控制跟踪重定向的最大次数。默认值通常是 5。

“`powershell

设置最大重定向次数为 10

Invoke-WebRequest -Uri “http://shorturl.example.com/xyz” -MaximumRedirection 10
“`

3.8 处理 SSL/TLS 证书问题 (-SkipCertificateCheck)

在某些情况下，你可能需要访问使用了自签名证书或证书链不受信任的 HTTPS 站点（例如内部开发环境）。-SkipCertificateCheck 参数可以禁用证书验证。

“`powershell

警告：使用此参数会降低安全性！仅在你知道风险并信任目标站点时使用。

Invoke-WebRequest -Uri “https://internal-site-with-untrusted-cert.local” -SkipCertificateCheck
“`

强烈建议: 避免在生产环境或访问未知站点时使用此参数。更好的做法是将站点的证书导入到系统的信任存储中。

4. Invoke-WebRequest vs. Invoke-RestMethod

除了 Invoke-WebRequest，PowerShell 还有一个相关的 Cmdlet 叫做 Invoke-RestMethod (IRM)。它们都是用于进行 Web 请求，但侧重点不同：

  • Invoke-WebRequest (IWR):

    • 返回一个包含丰富信息的对象 (HtmlWebResponseObject 等)，包括状态码、头、原始内容，以及最重要的对 HTML 内容的结构化解析 (.ParsedHtml, .Forms, .Links 等)。
    • 更适合于需要与网站进行广泛交互的场景，比如 Web 数据抓取、模拟用户浏览、处理 HTML 表单等。

  • Invoke-RestMethod (IRM):

    • 主要用于与 RESTful API 交互。它会尝试根据 Content-Type (如 application/json, application/xml) 自动将响应体解析为 PowerShell 对象。
    • 返回的对象通常就是解析后的数据本身（例如，如果 API 返回 JSON 数组，IRM 直接返回一个 PowerShell 数组对象）。它不提供像 IWR 那样详细的响应头、状态码属性，除非你专门去访问它们（例如通过 [System.Net.HttpWebResponse]$response = Invoke-RestMethod ...; $response.StatusCode，但这不常用）。
    • 更适合于需要获取结构化数据并直接在脚本中处理的场景，比如调用各种 Web API。

总结:

  • 如果你需要下载文件，或者需要详细检查响应的各个方面（状态码、头、原始内容）或与 HTML 页面元素交互，使用 Invoke-WebRequest。
  • 如果你主要与返回 JSON 或 XML 数据的 Web API 交互，并且想直接将响应数据作为 PowerShell 对象进行处理，那么 Invoke-RestMethod 通常更方便。

在下载文件的场景下，Invoke-WebRequest 配合 -OutFile 是你的首选，它直接对应了 wget 的核心功能。

5. 实际应用场景示例

5.1 自动化软件下载

“`powershell

定义下载链接和保存路径

$downloadUrl = “https://github.com/PowerShell/PowerShell/releases/download/v7.4.2/PowerShell-7.4.2-win-x64.zip”
$outputPath = “$env:TEMP\PowerShell-7.4.2-win-x64.zip”

Write-Host “正在下载 PowerShell 7.4.2…”

try {
# 使用 Invoke-WebRequest 下载文件
# 如果是较新的PowerShell版本，下载过程中会显示进度条
Invoke-WebRequest -Uri $downloadUrl -OutFile $outputPath -UseBasicParsing # -UseBasicParsing 在某些旧版本或特定情况下可能有助于避免HTML解析问题，新版本通常不需要

Write-Host "下载完成！文件已保存到: $outputPath"

# 可选：验证文件是否存在或大小
If (Test-Path $outputPath) {
    $fileInfo = Get-Item $outputPath
    Write-Host "文件大小: $($fileInfo.Length / 1MB) MB"
}

} catch {
Write-Error “下载失败: $($_.Exception.Message)”
}
“`

5.2 检查网站可用性

“`powershell
$website = “https://www.microsoft.com”

try {
Write-Host “正在检查 $website …”
# 发送 HEAD 请求以减少传输数据量，只关心状态码
$response = Invoke-WebRequest -Uri $website -Method HEAD -MaximumRedirection 0 -TimeoutSec 10 # 设置超时和不跟踪重定向以快速检查

# 检查状态码是否表示成功 (200-299)
if ($response.StatusCode -ge 200 -and $response.StatusCode -lt 300) {
    Write-Host "$website 状态正常 (StatusCode: $($response.StatusCode))"
} else {
    Write-Warning "$website 返回非成功状态码: $($response.StatusCode)"
}

} catch {
Write-Error “检查 $website 时发生错误: $($.Exception.Message)”
# 可能是连接超时，DNS问题等
if ($.Exception -is [System.Net.WebException]) {
Write-Error “Web异常: $($_.Exception.Status)”
}
}
“`

5.3 简单的网页数据抓取

“`powershell
$url = “https://www.example.com”

try {
$page = Invoke-WebRequest -Uri $url

# 假设你想获取页面标题
$title = $page.ParsedHtml.title.innerText
Write-Host "页面标题: $title"

# 假设你想获取页面上所有链接的文本和 HREF
Write-Host "页面链接:"
$page.Links | ForEach-Object {
    Write-Host "- Text: $($_.innerText), HREF: $($_.href)"
}

# 假设你想获取某个特定class的div内容
# 注意：这里的Selector语法可能需要根据实际HTML结构调整
$specificDiv = $page.ParsedHtml.querySelectorAll('.some-css-class')
if ($specificDiv) {
    Write-Host "找到特定div:"
    $specificDiv | ForEach-Object {
        Write-Host $_.outerHTML
    }
}

} catch {
Write-Error “抓取数据失败: $($_.Exception.Message)”
}
``
请注意，对于复杂的或需要 JavaScript 渲染的网页，Invoke-WebRequest` 的内置 HTML 解析功能可能不足。在这些情况下，你可能需要借助更专业的工具或库（如 Selenium 与 PowerShell 结合）来处理。

6. 性能与注意事项

  • 进度条: 在较新版本的 PowerShell (如 PowerShell Core 6.0+) 中，使用 -OutFile 下载文件时，Invoke-WebRequest 通常会自动显示下载进度。在较旧的 Windows PowerShell 版本中，可能没有内置的进度条，或者需要通过 -TransferEncoding Chunked 等参数（并非总有效）或编写自定义脚本来模拟。
  • 大文件下载: 对于非常大的文件，虽然 -OutFile 是流式处理，但下载过程中可能仍然会占用一定的内存和网络带宽。确保系统资源充足。
  • 并发下载: Invoke-WebRequest 本身是同步执行的。如果你需要同时下载多个文件，需要结合 PowerShell 的多线程或异步功能（如 Start-Job 或 Start-ThreadJob）来实现。
  • 错误处理: 总是建议在脚本中使用 try/catch 块来捕获 Invoke-WebRequest 可能抛出的错误，例如网络连接失败、DNS 解析错误、HTTP 错误状态码 (404, 500 等) 等。
  • -UseBasicParsing: 在某些旧版本的 PowerShell 中，默认的 HTML 解析器 (InternetExplorer COM 对象) 可能导致性能问题或兼容性问题。-UseBasicParsing 参数会强制使用基础解析器，避免这些问题，但在较新的 PowerShell 版本中，基础解析器已是默认或性能更高，此参数可能不再需要或作用不大。

7. 总结

Invoke-WebRequest 是 PowerShell 环境中一个功能全面、与系统深度集成的 Web 请求 Cmdlet。通过其内置的 HTML 解析能力、灵活的参数选项以及对会话和头部管理的良好支持，它完全能够胜任文件下载、API 调用、简单的网页自动化等多种任务。

更重要的是，通过 wget 和 curl 这两个别名，Invoke-WebRequest 为那些从其他平台迁移或需要在不同环境之间切换的工程师提供了极大的便利。虽然它的参数语法与原生 curl 或 wget 不完全相同，但其核心的文件下载 (-OutFile) 和基本的 Web 请求功能通过这些熟悉的别名得以快速应用。

因此，对于 Windows 用户，尤其是 PowerShell 的使用者来说，掌握 Invoke-WebRequest 的用法，就如同在 Linux 下掌握 curl 或 wget 一样，它是进行网络交互、自动化和脚本编程的强大工具。下次当你想在 PowerShell 中下载文件或与 Web 服务交互时，不妨试试这个原生的强大 Cmdlet——无论是输入 Invoke-WebRequest 还是习惯性的 wget 或 curl，它都不会让你失望。

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部