自定义PowerShell Module嵌套AD模块后调用AD cmdlet误导入问题求解

问题根因 #

这是PowerShell模块自动加载机制的正常表现：当你在自定义模块的清单中将ActiveDirectory配置为NestedModules时，PowerShell生成模块命令索引时，默认会将嵌套模块的所有公开命令（包括AD原生cmdlet）关联到你的自定义模块上。当你调用Get-ADUser等AD原生命令时，自动加载逻辑匹配到该命令关联了你的自定义模块，就会优先加载你的自定义模块，而非原生的ActiveDirectory模块。

解决方法 #

你可以选择以下任意一种方案修复：

• 方案1：移除清单中的NestedModules配置，改为在自定义函数内部按需加载ActiveDirectory模块
  修改你的自定义函数代码，在函数开头加入模块加载判断：

  function Add-UserToSpecificGroup {
      Param(
          [Parameter(Mandatory=$true)]
          [string]
          $Username,
          [Parameter(Mandatory=$true)]
          [System.Management.Automation.PSCredential]
          $DomainAdminCreds,
      )
      # 按需加载ActiveDirectory模块
      if (-not (Get-Module ActiveDirectory)) {
          Import-Module ActiveDirectory -ErrorAction Stop
      }
      Add-ADGroupMember -Identity $(Get-ADGroup -Identity "Specific Group") -Members $Username -Credential $DomainAdminCreds -Server servername.domain  -Confirm:$false
  }
  

  同时删除模块清单里的NestedModules = @('ActiveDirectory')配置即可。该方案最符合你的需求，只有调用你自定义的函数时才会触发AD模块加载，调用原生AD命令只会加载原生AD模块。

• 方案2：如果你必须保留NestedModules配置，需要在模块清单中显式限制所有导出项，避免嵌套模块的命令被关联到你的自定义模块
  把你的模块清单相关配置修改为如下内容：

  NestedModules = @('ActiveDirectory')
  # 仅导出你自定义的函数
  FunctionsToExport = @('Add-UserToSpecificGroup')
  # 显式指定不导出任何cmdlet、别名、变量，避免嵌套模块的内容被导出
  CmdletsToExport = @()
  AliasesToExport = @()
  VariablesToExport = @()
  

  修改完成后执行Remove-Module 你的自定义模块名卸载已加载的模块，再执行Get-Command -Module 你的自定义模块名确认仅显示你自己的自定义函数即可。

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