Docker容器中PowerShell模块无法识别的问题排查

你遇到的问题核心是PowerShell模块的安装路径权限问题：默认情况下Install-Module会将模块安装到当前用户的私有目录，但容器启动时的执行环境无法访问该目录，导致脚本找不到已安装的模块。

具体修复步骤 #

1. 信任PowerShell Gallery仓库：先将PSGallery设为信任状态，避免构建过程中因仓库未信任导致的静默安装异常。
2. 指定全局安装范围：通过-Scope AllUsers参数将模块安装到全局路径，确保容器启动时的用户能加载到模块。
3. 合并安装指令：将多个模块安装命令合并为一个RUN指令，减少镜像层数，同时保证命令执行的连续性。

修改后的Dockerfile #

FROM mcr.microsoft.com/powershell:latest
WORKDIR /app
COPY ./export_tenant.ps1 /app

SHELL ["pwsh", "-Command"]
RUN Set-PSRepository -Name PSGallery -InstallationPolicy Trusted; \
    Install-Module ExchangeOnlineManagement -RequiredVersion 3.0.0 -Scope AllUsers -Confirm:$false -Force; \
    Install-Module AzureADPreview -Scope AllUsers -Confirm:$false -Force; \
    Install-Module MSOnline -Scope AllUsers -Confirm:$false -Force; \
    Install-Module MicrosoftTeams -Scope AllUsers -Confirm:$false -Force; \
    Install-Module Microsoft.Online.SharePoint.PowerShell -Scope AllUsers -Confirm:$false -Force; \
    Install-Module Microsoft.Graph -Scope AllUsers -Confirm:$false -Force

CMD ["pwsh", "-File", "export_tenant.ps1"]

验证方法 #

如果仍有问题，可启动临时容器查看已安装模块列表，确认模块是否在全局路径中：

docker run --rm <你的镜像名称> pwsh -Command "Get-Module -ListAvailable"

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