PowerShell模块显示已导入但函数无法调用，求助排查原因

现象描述 #

1. 使用-Verbose和-Force参数导入ModDS_USB_dev.psm1模块时，日志显示模块加载、函数导出/导入流程均正常：

>Module Path is E:\Data\Computing\Software\Programming\Scripts\dev\ModDS_USB_dev.psm1

VERBOSE: Loading module from path 
'E:\Data\Computing\Software\Programming\Scripts\dev\ModDS_USB_dev.psm1'.
VERBOSE: Exporting function 'Test-USBModuleLoaded'.
VERBOSE: Exporting function 'Confirm-USB_Mounted'.
VERBOSE: Exporting function 'Dismount-USB'.
VERBOSE: Exporting function 'Get-DriveLetter'.
VERBOSE: Importing function 'Confirm-USB_Mounted'.
VERBOSE: Importing function 'Dismount-USB'.
VERBOSE: Importing function 'Get-DriveLetter'.
VERBOSE: Importing function 'Test-USBModuleLoaded'.

2. 执行Get-Module验证，模块ModDS_USB_dev已加载，且列出了所有应导出的函数：

>
Script     4.8.5      Logging                             {Add-LoggingLevel, Add-LoggingTarget, Get-LoggingAvailableTarge...
Manifest   3.1.0.0    Microsoft.PowerShell.Management     {Add-Computer, Add-Content, Checkpoint-Computer, Clear-Content...}
Manifest   3.1.0.0    Microsoft.PowerShell.Utility        {Add-Member, Add-Type, Clear-Variable, Compare-Object...}         
Script     0.0        ModDS_FileMgt02_dev                 {Backup_Folder, Import-Modules, Remove-OldBackups, Test-FileMgt...
Script     0.0        ModDS_Misc_dev                      {Convert-RawFiles, Get-UserInput, Get-UserInputViaForm, Initial...
Script     0.0        ModDS_USB_dev                       {Confirm-USB_Mounted, Dismount-USB, Get-DriveLetter, Test-USBMo...

3. 但在UnloadImagesSD_dev.ps1脚本中调用模块函数时，收到"未识别命令"错误：

Test-USBModuleLoaded : The term 'Test-USBModuleLoaded' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At E:\Data\Computing\Software\Programming\Scripts\dev\UnloadImagesSD_dev.ps1:148 char:1
+ Test-USBModuleLoaded
+ ~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (Test-USBModuleLoaded:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException
 
Confirm-USB_Mounted : The term 'Confirm-USB_Mounted' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At E:\Data\Computing\Software\Programming\Scripts\dev\UnloadImagesSD_dev.ps1:159 char:1
+ Confirm-USB_Mounted    #  in module ModDS_USB_dev. This check could b ...
+ ~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (Confirm-USB_Mounted:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

调用脚本核心内容：

Test-USBModuleLoaded
Confirm-USB_Mounted

可能原因及解决方法 #

1. 模块导入作用域限制 #

PowerShell默认在脚本内导入模块时，函数仅对脚本自身作用域可见。如果导入模块的代码放在子作用域（比如函数内部），或者脚本被其他进程/脚本间接调用，顶层代码就无法访问这些函数。

解决：

• 导入模块时添加-Scope Global参数，强制将函数导入全局作用域：

Import-Module .\ModDS_USB_dev.psm1 -Verbose -Force -Scope Global

• 确保导入模块的代码在脚本顶层作用域执行，不要嵌套在函数、循环等子作用域中。

2. 模块导出逻辑不明确 #

虽然日志显示导出了函数，但模块内部可能未明确指定导出规则：

• 检查ModDS_USB_dev.psm1文件末尾，确认是否存在Export-ModuleMember命令。如果没有，PowerShell默认导出所有未标记为private:的函数，但如果模块有特殊作用域设置，可能导致函数无法正常导出。
• 示例正确导出写法：

# 在模块文件末尾添加
Export-ModuleMember -Function Test-USBModuleLoaded, Confirm-USB_Mounted, Dismount-USB, Get-DriveLetter

3. 模块重复加载或版本冲突 #

可能存在多个版本的ModDS_USB_dev模块，Get-Module显示的是旧版本，而实际生效的版本未正确导出函数。

解决：先卸载所有该模块实例，再重新导入：

Get-Module ModDS_USB_dev | Remove-Module -Force
Import-Module .\ModDS_USB_dev.psm1 -Verbose -Force

4. 函数名称拼写验证 #

虽然日志显示名称一致，但仍需核对调用的函数名与模块导出的名称是否完全匹配（PowerShell不区分大小写，但下划线、符号必须完全一致）。

内容的提问来源于stack exchange，提问作者Davy