PowerShell二进制模块问题：无法在PS 5.1中加载Automation模块

我来帮你搞定这个问题——你遇到的核心矛盾是开发环境（PowerShell 7.1，基于.NET Core）和目标运行环境（PowerShell 5.1，基于.NET Framework）的依赖版本完全不匹配。下面拆解原因并给出一步步的修复方案：

问题到底出在哪？ #

• PowerShell 5.1 底层依赖的是 .NET Framework版本的System.Management.Automation（程序集版本通常是3.0.0.0，PublicKeyToken为31bf3856ad364e35）。但你在项目里直接引用了System.Management.Automation 6.0.4，这是PowerShell Core 6.x专属的.NET Core版本程序集，PS5.1的.NET Framework运行时根本找不到这个版本的文件。
• 你用的PowerShellStandard.Library 5.1.0-preview-06是预览版，本身就可能存在兼容性坑。而且PSStandard的核心作用就是让模块同时兼容PS5.1和PS7+，但你额外加的特定版本SMA引用直接破坏了这个兼容性设计。

具体修复步骤 #

1. 彻底修改你的.csproj配置 #

PowerShellStandard.Library已经内置了兼容PS5.1和PS7的System.Management.Automation抽象层，完全不需要单独引用特定版本的SMA包。修改后的.csproj应该是这样：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Library</OutputType>
    <!-- 同时指定.NET Framework 4.7.2（PS5.1支持的最低版本）和.NET Standard 2.0，兼顾两个环境 -->
    <TargetFrameworks>net472;netstandard2.0</TargetFrameworks>
    <AssemblyName>assemblyName</AssemblyName>
    <!-- 让编译输出合并到一个目录，方便模块打包 -->
    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
    <OutputPath>bin\$(Configuration)\</OutputPath>
  </PropertyGroup>
  <ItemGroup>
    <!-- 换成稳定版的PowerShellStandard.Library，别用预览版了 -->
    <PackageReference Include="PowerShellStandard.Library" Version="5.1.0">
      <PrivateAssets>All</PrivateAssets>
    </PackageReference>
  </ItemGroup>
</Project>

这里几个关键调整：

• 把TargetFramework改成TargetFrameworks（复数），同时指定net472和netstandard2.0，这样编译出来的程序集能同时适配PS5.1和PS7+。
• 删掉单独的System.Management.Automation包引用，彻底避免版本冲突。
• 用稳定版的PowerShellStandard.Library 5.1.0，预览版的兼容性问题很多。

2. 重新编译模块 #

执行下面的命令清理旧编译文件，然后重新构建：

dotnet clean
dotnet build --configuration Release

3. 确保模块目录结构和psd1配置正确 #

PowerShell二进制模块需要固定的目录结构，比如：

assemblyName/
├─ assemblyName.psd1
└─ assemblyName.dll

你的.psd1文件里必须明确指定兼容两个PowerShell版本，并且正确指向DLL：

@{
    RootModule = 'assemblyName.dll'
    ModuleVersion = '1.0.0'
    # 声明同时兼容Desktop（PS5.1）和Core（PS7+）
    CompatiblePSEditions = @('Desktop', 'Core')
    # 其他模块元信息（作者、描述等）按需补充
}

4. 测试导入 #

切换到PowerShell 5.1环境，执行导入命令验证：

Import-Module .\assemblyName -Verbose

如果还有问题，可以用dotnet list package检查项目依赖，或者用.NET Framework的ildasm.exe查看编译出的DLL引用的程序集版本，确保没有硬编码PS Core版本的SMA。

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