Docker容器运行PowerShell脚本时ActiveDirectory模块不可用报错

三个报错对应三个明确的问题点：

• WARNING: Unable to find module repositories：容器内PowerShell默认TLS版本过低，NuGet包提供程序未预装，默认PS仓库配置在无桌面环境的容器镜像中不会自动初始化，导致找不到可用模块源
• No match was found for the specified search criteria and module name 'ActiveDirectory'：ActiveDirectory模块从未在PowerShell Gallery公开发布，它是Windows远程服务器管理工具（RSAT）的内置系统组件，直接执行Install-Module ActiveDirectory必然搜不到包
• AD相关命令无法识别：模块未成功安装，自然无法加载对应cmdlet

1. 优先选择适配的基础镜像 #

原生ActiveDirectory模块仅能在Windows环境下运行，如果要100%兼容所有AD命令，不要使用Linux基础镜像，直接换用Windows Server Core带PowerShell的基础镜像，这是成本最低、兼容性最好的方案。

2. 在镜像构建阶段提前配置模块源 #

不要把仓库注册、依赖安装的逻辑放到业务脚本运行阶段执行，直接在Dockerfile构建阶段完成所有环境配置，避免运行时权限、网络问题导致配置失败：

# 配置PS仓库、安装NuGet提供程序
RUN pwsh -Command \
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; \
    Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force; \
    Register-PSRepository -Name PSGallery -SourceLocation https://www.powershellgallery.com/api/v2/ -InstallationPolicy Trusted;

企业内网环境可以把源地址替换为内部私有PS仓库地址，不需要走公网访问。

3. 安装ActiveDirectory模块 #

如果使用Windows容器基础镜像，直接在Dockerfile中执行命令安装RSAT AD PowerShell组件即可：

# Windows容器专用，安装原生AD模块
RUN pwsh -Command Install-WindowsFeature RSAT-AD-PowerShell

如果必须使用Linux容器，无法安装原生RSAT组件，两种替代方案：

• 自行封装调用AD LDAP/WS接口的逻辑，不依赖原生ActiveDirectory模块
• 安装第三方社区维护的AD兼容模块，注意模块名不是ActiveDirectory，需要对应调整脚本里的导入和调用逻辑

4. 修正脚本逻辑 #

删掉脚本开头冗余的Register-PSRepository、Install-Module ActiveDirectory逻辑，在脚本最开头加模块导入校验，避免运行时加载失败：

# 脚本开头强制导入AD模块，导入失败直接终止
Import-Module ActiveDirectory -ErrorAction Stop

# 后续业务逻辑正常编写
New-ADGroup -Name $SecurityGroup # 按需求补全组类型、路径等必填参数
Add-ADGroupMember -Identity $SecurityGroup -Members $userList

# 请替换为内部可信的Windows Server Core带PowerShell的基础镜像
FROM your-internal-registry/windows-servercore-powershell:ltsc2022
WORKDIR /app

# 构建阶段配置PS源、安装AD模块依赖
RUN pwsh -Command \
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; \
    Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force; \
    Register-PSRepository -Name PSGallery -SourceLocation https://www.powershellgallery.com/api/v2/ -InstallationPolicy Trusted; \
    Install-WindowsFeature RSAT-AD-PowerShell

# 复制脚本文件
COPY ./rabbitmq-adgroups-deploy/1.0/ /app

# 构建阶段验证模块安装正常
RUN pwsh -Command "Get-Module -ListAvailable ActiveDirectory | Out-Null; if (-not $?) { exit 1 }"

CMD [ "pwsh", "rabbitmq-adgroups.ps1" ]

镜像构建完成后，单独启动容器执行pwsh -c "Get-Command New-ADGroup"，如果能正常返回命令信息，说明环境配置正确，不会再出现命令不识别、模块找不到的问题。

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