Windows 上的irm终端命令详细介绍irm是 Windows PowerShell 5.0 和 PowerShell Core 中Invoke-RestMethod命令的内置别名。它是一个功能强大的命令行工具用于向 RESTful API 发送 HTTP/HTTPS 请求并直接解析返回的数据。近年来随着 Windows 生态中包管理器如 Winget、Chocolatey和远程脚本部署的普及irm因其“一行命令下载并执行脚本”的便捷性而频繁出现在各类官方安装文档中成为 Windows 高级用户和开发者的必备技能。1.irm是什么从本质上看irmInvoke-RestMethod PowerShell 版的curl但更侧重于结构化数据处理属性说明全称Invoke-RestMethod别名irm所属环境Windows PowerShell 5.0 / PowerShell 7跨平台核心功能发送 HTTP/HTTPS 请求自动解析 JSON/XML 响应为对象典型用途调用 REST API、下载文件、远程执行脚本、与 Web 服务交互与Invoke-WebRequest别名iwr的区别对比项irmInvoke-RestMethodiwrInvoke-WebRequest返回内容自动解析后的数据对象PSCustomObject完整的HTTP 响应对象含 Headers、StatusCode、Content 等JSON 处理自动将 JSON 转为 PowerShell 对象需要手动Content | ConvertFrom-Json适用场景调用 API、获取结构化数据需要检查响应头、状态码、下载原始内容使用复杂度更简洁直接可用更底层需手动解析简单记忆调 API 拿数据用irm看完整 HTTP 细节用iwr。2. 基本语法irm [-Uri] String [-Method String] [-Headers Hashtable] [-Body Object] [-ContentType String] [-OutFile String] [-TimeoutSec Int32] [-Proxy Uri] [-Credential PSCredential] [其他参数]最简用法# GET 请求自动解析 JSON irm https://api.github.com/users/microsoft输出示例login : microsoft id : 6154722 type : Organization name : Microsoft blog : https://www.microsoft.com location : Redmond, WA followers : 10000可以看到返回的 JSON 已被自动转换为 PowerShell 对象可以直接通过.访问属性。3. 核心参数详解3.1-Uri位置参数可省略指定请求的目标 URL。支持 HTTP 和 HTTPS。irm https://api.example.com/data3.2-Method指定 HTTP 方法可选值GET默认、POST、PUT、DELETE、PATCH、HEAD、OPTIONS等。# POST 请求 irm -Uri https://api.example.com/users -Method Post -Body $jsonBody3.3-Headers以哈希表形式设置请求头常用于传递 API Key、Token、User-Agent 等。$headers { Authorization Bearer $token Accept application/json } irm -Uri https://api.example.com/secure -Headers $headers3.4-Body请求体用于 POST/PUT/PATCH 请求。可接受字符串、哈希表、PSObject 等。# 方式一哈希表自动序列化 $body { name Alice; age 30 } irm -Uri https://api.example.com/users -Method Post -Body $body -ContentType application/json # 方式二手动构造 JSON 字符串 $jsonBody {name:Alice,age:30} irm -Uri https://api.example.com/users -Method Post -Body $jsonBody -ContentType application/json3.5-ContentType指定请求体的 MIME 类型常见值application/json、application/xml、application/x-www-form-urlencoded。3.6-OutFile将响应内容直接保存到文件类似于下载。irm -Uri https://example.com/file.zip -OutFile C:\Downloads\file.zip3.7-TimeoutSec设置请求超时时间秒默认 100 秒。irm -Uri https://slow-api.example.com -TimeoutSec 303.8-Proxy和-ProxyCredential通过代理服务器发送请求。irm -Uri https://api.example.com -Proxy http://proxy.company.com:80803.9-SkipCertificateCheckPowerShell 7跳过 SSL 证书验证仅用于测试环境不推荐生产使用。irm -Uri https://self-signed.example.com -SkipCertificateCheck4. 与管道符| iex的组合一行命令执行远程脚本这是irm在 Windows 上最广为人知的用法也是各大开发工具官方安装文档中的常见模式irm https://get.example.com/install.ps1 | iex4.1 执行原理irm https://...向远程服务器发送 HTTPS 请求获取脚本文件内容。脚本内容作为字符串通过管道传递给iexInvoke-Expression的别名。iex将字符串作为 PowerShell 代码在当前会话中执行。4.2 实际应用案例工具安装命令Chocolatey软件包管理器Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString(https://community.chocolatey.org/install.ps1))Scoop便携软件管理器irm get.scoop.sh | iexOh My Posh终端美化irm https://ohmyposh.dev/install.ps1 | iexRustRustup 安装器irm https://sh.rustup.rs | iex需安装 Rust 后Winget UI 等第三方工具各类开源项目常提供类似一键安装脚本4.3 安全风险与最佳实践⚠️重要警告irm ... | iex相当于“从互联网下载代码并立即执行”存在重大安全风险。潜在风险远程服务器被劫持脚本被篡改后植入恶意代码中间人攻击MITM替换脚本内容脚本本身存在漏洞或后门安全建议始终检查 URL 来源确认是官方域名。在执行前先查看脚本内容irm https://example.com/install.ps1 # 只看内容不执行保存后审查再执行irm https://example.com/install.ps1 -OutFile install.ps1 Get-Content install.ps1 # 人工审查 .\install.ps1 # 确认安全后执行使用 HTTPS确保加密传输防止中间人篡改。注意执行策略PowerShell 默认禁止运行脚本许多安装命令会先修改ExecutionPolicy需了解其影响。5. 实际应用场景5.1 调用 REST API 获取数据# 获取 GitHub 用户信息 $user irm https://api.github.com/users/octocat $user.name $user.followers # 获取天气数据 $weather irm https://api.openweathermap.org/data/2.5/weather?qBeijingappidYOUR_KEY $weather.main.temp $weather.weather[0].description5.2 批量下载文件$urls ( https://example.com/file1.zip, https://example.com/file2.zip ) $urls | ForEach-Object { $filename $_ -split / | Select-Object -Last 1 irm -Uri $_ -OutFile C:\Downloads\$filename }5.3 与 Webhook 交互# 发送消息到 Slack $body { text 部署完成 } | ConvertTo-Json irm -Uri https://hooks.slack.com/services/xxx -Method Post -Body $body -ContentType application/json5.4 检测 API 可用性try { $response irm -Uri https://api.example.com/health -TimeoutSec 10 if ($response.status -eq ok) { Write-Host API 正常 -ForegroundColor Green } } catch { Write-Host API 不可用: $($_.Exception.Message) -ForegroundColor Red }6. 与传统工具对比工具特点适用场景irmPowerShell自动解析 JSON/XML与 PS 对象无缝集成支持管道PowerShell 脚本、自动化运维、API 交互curlWindows 10 内置跨平台经典工具输出原始数据快速调试、非 PowerShell 环境wget专注下载支持断点续传、递归下载大规模文件下载Invoke-WebRequestiwr完整 HTTP 响应可访问 Headers/Cookies需要检查 HTTP 细节、会话管理选择建议在 PowerShell 脚本中处理 API 数据 → 用irm需要在 CMD/Bash 中跨平台使用 → 用curl只需下载大文件 → 用wget或irm -OutFile7. 常见错误与排查7.1 错误The response content cannot be parsed because the content type is not valid原因服务器返回的不是合法的 JSON/XML或者 Content-Type 头不正确。解决改用iwr查看原始响应或添加-ContentType参数。7.2 错误Unable to connect to the remote server原因网络不通、DNS 解析失败、防火墙拦截。解决检查网络连接、尝试Test-NetConnection诊断。7.3 错误The remote server returned an error: (403) Forbidden原因缺少认证信息或 API Key 无效。解决检查-Headers中的认证信息。7.4 错误The underlying connection was closed: Could not establish trust relationship原因SSL 证书验证失败自签名证书或证书过期。解决PowerShell 7 可使用-SkipCertificateCheckWindows PowerShell 5 需通过 .NET 设置。[System.Net.ServicePointManager]::ServerCertificateValidationCallback {$true}7.5 中文乱码原因服务器返回的编码不是 UTF-8。解决$response iwr -Uri https://example.com -UseBasicParsing $response.Content # 原始字符串可手动处理编码8. Windows PowerShell 5 与 PowerShell 7 的差异功能Windows PowerShell 5.1PowerShell 7irm可用性✅ 支持✅ 支持-SkipCertificateCheck❌ 不支持✅ 支持默认 TLS 版本1.0/1.1需手动升级1.2/1.3跨平台❌ 仅 Windows✅ Win/Mac/Linux性能较慢.NET Framework更快.NET Core/5建议优先安装并使用PowerShell 7获得更好的irm体验和安全性。9. 总结irmInvoke-RestMethod是 Windows PowerShell 中一个轻量但强大的 HTTP 客户端命令。它的核心优势在于自动解析JSON/XML 响应直接转为 PowerShell 对象省去手动反序列化。管道友好可与| iex组合实现一键安装也可与其他 cmdlet 无缝衔接。原生集成无需安装额外软件Windows 内置即用。安全可控支持 HTTPS、Headers、认证等完整 HTTP 功能。使用金句总结irm是 PowerShell 世界里“最会聊天的人”——它知道怎么向 REST API 提问发送请求也听得懂对方的回答自动解析 JSON/XML还能把聊天内容直接转交给下一个伙伴管道传递。无论是调用 API、下载文件还是官方文档里常见的irm ... | iex一键安装它都是 Windows 自动化脚本中的关键角色。用好irm你的 Windows 终端就多了一把瑞士军刀。