PowerShell脚本初始加载模块失败：作用域容量超4096及模块未找到

在PowerShell脚本开头尝试加载指定模块时，尽管已添加Import-Module PowerShellGet，仍出现模块未找到错误，同时触发「此作用域的函数容量已超出4096」的问题。

脚本内容如下：

Import-Module PowerShellGet

$ModuleList = @('ExchangeOnlineManagement', 'Microsoft.Graph', 'Az.Accounts', 'Az.Resources', 'MSOnline', 'AzureAD')

ForEach($module in $ModuleList) {
    
    If (Get-InstalledModule -Name $module -AllVersions)
    {
        $paramUpdateModule = @{
            Name    = $module
            Force   = $true
            Verbose = $true
        }
        
        Update-Module @paramUpdateModule
    }
    Else
    {
        $paramInstallModule = @{
            Name               = $module
            Scope              = 'AllUsers'
            AllowClobber       = $true
            Verbose            = $true
            SkipPublisherCheck = $true
            Force              = $true
        }
        
        Install-Module @paramInstallModule
    }
}

错误提示：模块未找到，且存在「此作用域的函数容量已超出4096」的限制问题。

1. 解决PowerShellGet模块加载问题 #

• 必须使用管理员权限运行PowerShell，否则无法访问系统级模块路径，容易触发未找到模块的错误。
• 改用强制重新导入的方式，同时导入PowerShellGet的依赖模块PackageManagement：

  # 强制重新导入，跳过版本和缓存检查
  Import-Module PowerShellGet -Force -SkipEditionCheck
  Import-Module PackageManagement -Force -SkipEditionCheck
  

• 若仍提示模块未找到，先手动更新NuGet并重新安装PowerShellGet：

  Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
  Install-Module -Name PowerShellGet -Force -AllowClobber
  

2. 解决「函数容量超出4096」问题 #

该错误源于旧版PowerShell对单个作用域内函数数量的限制，可通过以下方式解决：

• 升级PowerShell到5.1以上版本（推荐7.x系列），新版已移除该限制。
• 若无法升级，将模块导入到全局作用域，避免占用当前脚本作用域的函数配额：
  修改循环内的逻辑，在安装/更新后添加全局导入：

  ForEach($module in $ModuleList) {
      If (Get-InstalledModule -Name $module -AllVersions)
      {
          $paramUpdateModule = @{
              Name    = $module
              Force   = $true
              Verbose = $true
          }
          Update-Module @paramUpdateModule
          # 全局导入模块
          Import-Module $module -Scope Global -Force
      }
      Else
      {
          $paramInstallModule = @{
              Name               = $module
              Scope              = 'AllUsers'
              AllowClobber       = $true
              Verbose            = $true
              SkipPublisherCheck = $true
              Force              = $true
          }
          Install-Module @paramInstallModule
          # 全局导入模块
          Import-Module $module -Scope Global -Force
      }
  }
  

3. 优化脚本逻辑 #

• 拆分模块检查逻辑，先确认模块是否可导入，再执行安装/更新，避免重复操作：

  # 先确保依赖模块正常加载
  Import-Module PowerShellGet, PackageManagement -Force -SkipEditionCheck
  
  $ModuleList = @('ExchangeOnlineManagement', 'Microsoft.Graph', 'Az.Accounts', 'Az.Resources', 'MSOnline', 'AzureAD')
  
  foreach ($module in $ModuleList) {
      # 先检查模块是否已存在
      if (-not (Get-Module -Name $module -ListAvailable)) {
          Install-Module -Name $module -Scope AllUsers -AllowClobber -Verbose -SkipPublisherCheck -Force
      }
      # 全局导入确保脚本可用
      Import-Module $module -Scope Global -Force -Verbose
  }
  

• 注意：MSOnline和AzureAD模块已被官方弃用，推荐改用Microsoft.Graph.Identity.DirectoryManagement模块替代。

内容的提问来源于stack exchange，提问作者Senior Systems Engineer