---
title: "PowerShell 中 Install-Module 命令缺失的排查与修复"
description: "旧版 Windows 自带的 PowerShell 缺少 Install-Module，无法从在线库安装模块。本文说明成因、升级 Windows Management Framework 的准备与风险、操作步骤、验证方法、回退建议及常见问题，面向企业 IT 运维。"
url: "https://www.lanever.com/docs/powershell-%e4%b8%ad-install-module-%e5%91%bd%e4%bb%a4%e7%bc%ba%e5%a4%b1%e7%9a%84%e6%8e%92%e6%9f%a5%e4%b8%8e%e4%bf%ae%e5%a4%8d/"
updated: "2026-10-12"
category: Exchange
---

# PowerShell 中 Install-Module 命令缺失的排查与修复

> **参考来源与致谢**
>
>
>
> - **引用来源：**[How to Fix Install-Module is missing in PowerShell](https://winaero.com/fix-install-module-missing-powershell/)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

在 Windows 7、Windows 8.1 或早期 Windows Server 上执行 `Install-Module` 时，控制台报错：

```
The term 'Install-Module' is not recognized as the name of a cmdlet, function, script file, or operable program.
```

该 cmdlet 由 PowerShellGet 模块提供，随 PowerShell 5.1 及更高版本内置。旧系统默认携带 PowerShell 2.0 至 4.0，因此命令不存在。若运维脚本依赖从在线库拉取模块，需要先补齐运行环境。

## 准备与风险

- 确认当前版本：在 PowerShell 中执行 `$PSVersionTable.PSVersion`，记录主版本号。
- 升级 Windows Management Framework（WMF）会替换 PowerShell 引擎，可能影响依赖旧版行为的脚本、计划任务和第三方管理单元。
- 升级前必须完成：系统盘与关键数据的完整备份；在测试环境先行验证；确认业务脚本在目标版本下可运行。
- 记录当前补丁级别与已安装更新，便于回退时比对。
- WMF 版本与操作系统的对应关系随系统版本变化，安装前请查阅对应版本的官方文档，不要凭经验套用。

## 处理步骤

1. 在测试机确认问题可复现，记录报错原文。
2. 从官方渠道获取与操作系统版本、架构匹配的 WMF 安装包。架构分为 32 位与 64 位，需与系统一致。
3. 关闭正在运行的 PowerShell 会话与管理控制台，避免文件占用。
4. 以管理员身份运行安装包，按提示完成安装。
5. 按提示重启系统，使新引擎生效。
6. 重启后重新打开 PowerShell，检查版本与模块可用性。

> 若企业策略不允许升级系统组件，可评估使用独立安装的跨平台 PowerShell 版本作为替代，但需先确认其与现有脚本、模块源的兼容性，并查阅该版本官方文档。

## 验证方法

- 执行 `$PSVersionTable.PSVersion`，确认主版本已提升。
- 执行 `Get-Command -Name Install-Module`，应返回命令来源模块信息。
- 执行 `Get-Module -ListAvailable PowerShellGet`，确认 PowerShellGet 已就位。
- 在测试环境执行一次只读查询，例如 `Find-Module -Name [模块名称]`，确认可访问模块源。生产环境请先确认源地址与代理策略。

## 回退建议

- 升级前创建系统还原点或虚拟机快照，作为首选回退手段。
- 若升级后业务脚本异常，先卸载对应 WMF 更新，再重启验证。
- 回退后重新核对补丁级别，避免残留组件导致状态不一致。
- 回退操作同样需要备份与变更窗口，不要在业务高峰执行。

## 常见问题

### 升级后仍提示命令不存在

多为会话未重启或加载了旧版引擎。关闭全部 PowerShell 窗口后重新打开，再确认版本号。

### 能识别命令但无法下载模块

检查网络出口、代理设置与模块源配置。企业内网通常需要指向内部源，具体配置方式请查阅对应版本官方文档。

### 模块安装位置在哪

未指定作用域或指定为所有用户时，模块位于系统盘的 `Program FilesWindowsPowerShellModules`；指定为当前用户时，位于用户配置目录下的 `DocumentsWindowsPowerShellModules`。实际路径以当前版本行为为准。

### 是否必须升级系统组件

不一定。可评估独立 PowerShell 版本或内部模块分发方案，但均需在测试环境验证兼容性，并查阅对应版本官方文档确认支持范围。
