PowerShell加载.NET依赖优先应用目录而非模块目录的机制与原因咨询

.NET程序集加载核心逻辑 #

.NET的程序集探测遵循固定优先级顺序，这是问题的根源：

• 首先检查宿主进程的应用基目录（即启动进程的可执行文件所在目录，对应你的应用目录）。
• 其次检查全局程序集缓存（GAC）。
• 最后才会查找配置文件指定的私有路径或程序集所在的子目录。

对于强命名程序集（如Microsoft.Graph.Core.dll），.NET会严格匹配版本号，除非存在绑定重定向配置。你的应用目录中存在2.0.9.0版本的DLL，按照探测顺序会被优先加载，与Microsoft Graph模块所需的3.0.9.0版本不兼容，导致类签名匹配失败。

PowerShell模块的依赖加载逻辑 #

PowerShell模块（尤其是二进制模块）通常会将依赖DLL放在模块目录的Dependencies子目录中，并通过以下方式确保加载正确版本：

• 模块清单（.psd1）中声明依赖项及版本要求。
• 模块加载脚本（.psm1）通过Add-Type显式指定DLL路径加载。

命令行PowerShell的宿主进程是powershell.exe（或pwsh.exe），其应用基目录为PowerShell的安装目录（如C:\Windows\System32\WindowsPowerShell\v1.0），而非你的应用目录。即使你切换工作目录到应用目录，.NET的探测优先级仍以宿主进程的应用基目录为准，因此会优先加载模块Dependencies目录下的3.0.9.0版本DLL，不会出现冲突。

应用内嵌PowerShell环境的差异 #

你的应用作为PowerShell的自定义宿主进程，其应用基目录就是自身的安装目录（包含2.0.9.0版本DLL的目录）。当PowerShell加载Microsoft Graph模块时，.NET按探测顺序先找到应用目录中的旧版本DLL，而非模块指定路径的新版本，从而触发兼容性错误。

不修改应用原有DLL的解决方案 #

1. 显式加载模块指定版本的DLL #

在创建PowerShell运行空间时，先通过Add-Type加载模块Dependencies目录下的3.0.9.0版本Microsoft.Graph.Core.dll，强制.NET优先使用该版本：

var initialSessionState = InitialSessionState.CreateDefault();
string coreDllPath = @"C:\Program Files\WindowsPowerShell\Modules\microsoft.graph.Authentication\2.8.0\Dependencies\Microsoft.Graph.Core.dll";

// 添加Add-Type命令到会话状态
initialSessionState.Commands.Add(new SessionStateCommandEntry(
    "Add-Type", 
    typeof(Microsoft.PowerShell.Commands.AddTypeCommand), 
    null
));

using (var ps = PowerShell.Create(initialSessionState))
{
    // 先加载指定版本的核心DLL
    ps.AddCommand("Add-Type").AddParameter("Path", coreDllPath);
    ps.Invoke();

    // 再导入Microsoft Graph模块
    ps.Commands.Clear();
    ps.AddCommand("Import-Module")
      .AddParameter("Name", "Microsoft.Graph.User")
      .AddParameter("RequiredVersion", "2.8.0");
    ps.Invoke();

    // 执行Update-MgUser等操作
    ps.Commands.Clear();
    ps.AddCommand("Update-MgUser")
      .AddParameter("UserId", "user-id")
      .AddParameter("DisplayName", "New Name");
    var results = ps.Invoke();
}

2. 配置应用程序域私有路径（仅.NET Framework） #

如果你的应用基于.NET Framework，可以为PowerShell运行的应用程序域添加私有路径，指向模块的Dependencies目录，让.NET优先探测该路径：

AppDomainSetup setup = new AppDomainSetup();
setup.ApplicationBase = AppDomain.CurrentDomain.ApplicationBase;
// 添加模块依赖目录到私有路径
setup.PrivateBinPath = @"C:\Program Files\WindowsPowerShell\Modules\microsoft.graph.Authentication\2.8.0\Dependencies";

AppDomain psDomain = AppDomain.CreateDomain("PowerShellDomain", null, setup);
// 在新域中创建PowerShell运行空间...

3. 绑定重定向（需谨慎测试） #

在应用的app.config中添加绑定重定向，将2.0.9.0版本的请求重定向到3.0.9.0版本。注意：此操作可能影响应用其他依赖2.0.9.0的组件，必须充分测试兼容性：

<runtime>
  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
      <assemblyIdentity 
          name="Microsoft.Graph.Core" 
          publicKeyToken="31bf3856ad364e35" 
          culture="neutral" />
      <bindingRedirect oldVersion="2.0.9.0" newVersion="3.0.9.0" />
    </dependentAssembly>
  </assemblyBinding>
</runtime>

4. 使用PowerShell 7+的模块隔离机制 #

如果应用可以切换到PowerShell 7+，其模块系统使用ModuleAssemblyLoadContext隔离依赖，每个模块会加载自己的DLL版本，不受宿主进程的DLL影响。可以尝试升级应用使用的PowerShell版本，并确保Microsoft Graph模块支持该隔离机制。

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