PowerShell 模块：Import-Module

PowerShell 中的 Import-Module 是加载功能包的核心命令。模块（Module）本质是一组封装好的脚本、函数、别名和类型数据。系统默认仅加载内置模块，自定义或从网络下载的模块必须通过 Import-Module 手动引入当前会话，才能使用其中的命令。以下指南将带你完成模块的查找、导入、排错与验证。

阶段一：定位模块文件

在导入前，必须确认目标模块的文件已存在于本地磁盘，并记录其完整路径。PowerShell 默认从 $env:PSModulePath 环境变量（系统预设的模块存放目录集合）指定的路径中自动搜索模块。若模块位于非标准目录，需提供完整路径。

1. 打开 文件资源管理器，导航 至存放模块的文件夹。
2. 确认 文件夹内包含模块清单文件（扩展名为 .psd1，相当于模块的身份证和配置清单）或脚本模块文件（扩展名为 .psm1，包含实际可执行的函数代码）。模块文件夹名称必须与清单文件中的 RootModule 字段或脚本文件名保持一致。
3. 记录 模块所在的完整目录路径，例如 C:\MyScripts\NetworkTools，并在文本编辑器中暂存备用。

阶段二：执行导入操作

根据模块存放位置，选择对应的导入方式。推荐使用参数化调用，确保命令可重复且精准控制加载行为。

1. 启动 PowerShell 终端（Windows Terminal 或内置控制台均可），确保以所需的管理员或标准用户权限运行。
2. 输入 基础导入命令，替换 <模块名> 为实际文件夹名称或清单文件名（无需引号）：

   Import-Module -Name <模块名>

3. 指定 绝对路径（当模块不在默认环境变量中时），运行 带路径参数的命令：

   Import-Module -Name "C:\MyScripts\NetworkTools\NetworkTools.psd1"

4. 查看 详细加载过程，追加 -Verbose 参数以输出每一步调试信息，便于确认依赖项是否同时被拉取：

   Import-Module -Name <模块名> -Verbose

5. 强制 覆盖已加载版本，添加 -Force 参数（适用于开发调试阶段，避免 PowerShell 缓存旧版代码导致新修改不生效）：

   Import-Module -Name <模块名> -Force -Verbose

不同场景需搭配特定参数使用。下表列出高频参数及其作用边界，直接根据需求拼接至 -Name 参数之后即可。

阶段三：拦截与处理加载异常

导入失败通常由权限拦截、路径错误或执行策略限制引起。按顺序排查即可快速恢复。

1. 拦截 终端输出的红色报错文本，核对 具体错误代码或提示短语。常见拦截分为策略拒绝与路径缺失两类。
2. 解除 脚本执行策略限制，当终端提示 UnauthorizedAccess（未授权访问，系统默认禁止运行非签名脚本）时，运行 以下命令放宽当前用户的执行权限：

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

   确认 安全提示弹出时输入 Y 并按回车。此操作仅修改当前账户配置，不影响系统全局策略。

3. 修正 路径拼写错误，当提示 ModuleNotFound（模块未找到）时，检查 提供的路径是否精确指向了 .psd1 或 .psm1 文件本身。PowerShell 7 及以上版本要求提供绝对路径时，字符串必须包含完整的文件扩展名，否则将解析失败。
4. 清理 会话缓存冲突，当发现新修改的函数逻辑未生效时，执行 以下指令彻底卸载当前内存中的模块，随后重新运行导入命令：

   Remove-Module -Name <模块名> -Force
   Import-Module -Name <模块名>

阶段四：验证模块可用性

命令执行完毕且无报错提示，不代表功能已完全就绪。必须验证命令列表是否成功注入当前运行环境。

1. 查询 模块元数据，运行 以下指令确认模块版本、路径与加载状态：

   Get-Module -Name <模块名> -ListAvailable

   若终端返回包含 Version 和 Path 字段的表格对象，证明系统已识别该模块文件。

2. 列出 所有新增命令，输入 以下过滤查询，终端将返回该模块公开的所有可调用项：

   Get-Command -Module <模块名>

   检查输出结果是否包含预期函数名。若返回空白，说明模块文件存在但未配置导出规则。

3. 调用 核心功能进行冒烟测试，选取 返回列表中的任意命令并执行。例如模块名为 LogCleaner 且包含 Clear-TempLogs 函数，则运行：

   Clear-TempLogs -Path "C:\Windows\Temp"

   若命令成功执行且返回预期结果，判定模块导入流程完成，可在当前会话中自由调用。若终端返回 The term '...' is not recognized as a name of a cmdlet, function, script file, or operable program（无法识别的命令），说明模块源码未正确声明导出，需打开 .psm1 文件末尾追加 Export-ModuleMember -Function * 语句并重新导入。