使用未批准动词的PowerShell模块无法自动导入的解决需求

核心方案：监听命令未找到事件实现按需导入 #

PowerShell默认的自动模块导入机制会忽略未批准动词的命令，我们可以通过监听CommandNotFound事件，在命令触发报错时自动导入对应模块：

1. 查看或创建PowerShell配置文件：

   # 查看当前用户的配置文件路径
   $PROFILE
   # 如果文件不存在，创建配置文件
   New-Item -Path $PROFILE -ItemType File -Force
   

2. 在配置文件中添加以下事件处理代码：

   # 注册命令未找到事件，自动导入自定义模块
   Register-EngineEvent -SourceIdentifier PowerShell.CommandNotFound -Action {
       # 定义需要自动导入的命令列表
       $targetCommands = 'Encode-Path', 'Decode-Path'
       if ($EventArgs.CommandName -in $targetCommands) {
           # 导入foo模块并禁用未批准动词警告
           Import-Module foo -DisableNameChecking
           # 执行用户原本调用的命令
           & $EventArgs.CommandName @($EventArgs.CommandArgs)
           # 标记事件已处理，避免抛出原始错误
           $EventArgs.Handled = $true
       }
   } | Out-Null
   

3. 重启PowerShell会话后，直接调用Encode-Path或Decode-Path时，系统会自动导入foo模块并执行命令，无需手动提前导入。

扩展优化（多模块/多命令场景） #

如果有多个自定义模块或命令，可以扩展逻辑自动扫描匹配，无需手动维护命令列表：

Register-EngineEvent -SourceIdentifier PowerShell.CommandNotFound -Action {
    $cmdName = $EventArgs.CommandName
    # 遍历所有可用模块，查找包含目标命令的模块
    $targetModule = Get-Module -ListAvailable | Where-Object {
        $exportedFuncs = $_ | Get-Content $_.Path.Replace('.psd1', '.psm1') | Select-String 'Function (\w+-\w+)' | ForEach-Object { $_.Matches.Groups[1].Value }
        $cmdName -in $exportedFuncs
    } | Select-Object -First 1

    if ($targetModule) {
        Import-Module $targetModule.Name -DisableNameChecking
        & $cmdName @($EventArgs.CommandArgs)
        $EventArgs.Handled = $true
    }
} | Out-Null

这个版本会自动识别包含目标命令的模块，适合管理多个自定义模块的场景。

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