Update-Help 更新帮助库
Update-Help 把最新的帮助内容下载到本机，解决离线环境下 Get-Help 只有命令骨架、看不到详细说明和示例的问题。它支持用 -Module 只更新指定模块，用 -Force 强制重新下载。企业内网常因代理限制或源站不可达而失败，不过失败并不影响命令本身使用，可以改用 Get-Help -Online 在浏览器里查看官方文档。
基本信息
| 适用平台 | Windows PowerShell 5.1 / PowerShell 7 |
|---|---|
| 语法 | Update-Help [-Module 模块] [-Force] |
| 权限 | 写入帮助目录需要管理员身份 |
| 常见失败 | 内网代理限制或无法访问源站 |
| 替代方式 | Get-Help -Online 打开官方文档 |
典型使用场景
- 新装机后补齐帮助内容，便于离线查询参数与示例
- 只更新常用模块的帮助，减少下载量与等待时间
- 排查 Get-Help 只显示语法、没有说明的原因
- 帮助内容损坏或不完整时强制重新下载
- 为离线环境预先准备帮助内容，减少现场查询依赖
常用示例
常用示例
Update-Help -Force # 更新全部模块帮助
Update-Help -Module Microsoft.PowerShell.Management -Force # 只更新指定模块
Get-Help Get-ChildItem -Full # 确认是否已有详细说明
Get-Help Get-ChildItem -Online # 打开在线文档（需联网）
Get-Help about_Execution_Policies # 查看概念性帮助主题参数与替代
| 参数或方式 | 作用 | 说明 |
|---|---|---|
| -Module | 只更新指定模块 | 减少下载量与时间 |
| -Force | 强制重新下载 | 用于修复内容不完整 |
| -Online | 打开在线文档 | 内网更新失败时的替代 |
| 管理员身份 | 写入帮助目录 | 普通用户可能被拒绝 |
企业内网更新失败很常见，失败并不影响命令可用；此时可以用 Get-Help -Online 打开官方文档，或只对确实需要的模块做定向更新。帮助内容只是本地文档，更新与否不会影响命令本身的执行结果。
更新会覆盖本机已有的帮助文件；离线环境如果依赖特定版本的帮助内容，更新之前先做好备份，避免内容被替换。内网机器建议统一通过内部源更新，比逐台联外网更可控。