PnP.PowerShell Docker镜像文档

镜像概述和主要用途

PnP.PowerShell是一个基于.NET 8的PowerShell模块，提供近800个cmdlet，用于Microsoft 365环境（如SharePoint Online、Microsoft Teams、Microsoft Project、安全与合规中心、Entra ID等）的管理与自动化。通过Docker容器化部署，可便捷地在隔离环境中运行PnP.PowerShell，实现Microsoft 365管理任务的自动化执行。

核心功能和特性

• 全面的Microsoft 365支持：覆盖SharePoint Online、Microsoft Teams、Microsoft Project、安全与合规中心、Entra ID等多个服务。
• 丰富的cmdlet集：提供近800个预定义cmdlet，满足日常管理与自动化需求。
• 跨平台容器化：支持Linux和Windows容器，可在不同操作系统环境中一致运行。
• 多架构支持：适配linux-amd64、windows-amd64、linux-arm32、linux-arm64等多种硬件架构。
• 版本控制：提供稳定版（stable/latest）和 nightly 构建版，满足不同场景的版本需求。

使用场景和适用范围

• Microsoft 365环境自动化管理：批量执行用户管理、内容部署、权限配置等重复性任务。
• 隔离环境执行：通过容器隔离PnP.PowerShell运行环境，避免对本地系统的依赖和干扰。
• 跨平台脚本运行：在Linux或Windows系统中统一运行PnP.PowerShell脚本，无需关注底层环境差异。
• CI/CD集成：作为自动化流水线的一部分，执行Microsoft 365环境的部署与配置脚本。

镜像标签

稳定版（latest/stable）

• latest：最新稳定版镜像（与stable标签等价）
  拉取命令：

  bash
  docker pull m365pnp/powershell
  # 或显式指定标签
  docker pull m365pnp/powershell:latest
  docker pull m365pnp/powershell:stable
  

Nightly构建版

• nightly：最新夜间构建版镜像（包含最新开发特性，稳定性未经验证）
  拉取命令：

  bash
  docker pull m365pnp/powershell:nightly
  

使用方法和配置说明

1. 启动隔离容器

运行一个安装了最新稳定版PnP.PowerShell模块的隔离容器，直接进入交互模式：

bash
docker run --rm -it m365pnp/powershell

说明：--rm表示容器退出后自动删除，-it启用交互终端。

2. 挂载本地目录并运行

将本地目录挂载到容器中，以便访问本地文件（如脚本、配置）。

Linux容器

bash
# 将当前目录（${PWD}）挂载到容器的/home目录，并设置工作目录为/home
docker run --rm -it -v ${PWD}:/home -w /home m365pnp/powershell

Windows容器

PowerShell
# 将当前目录（${PWD}）挂载到容器的c:/app目录，并设置工作目录为c:/app
docker run --rm -it -v ${PWD}:c:/app -w c:/app m365pnp/powershell

3. 运行本地脚本（无人值守模式）

直接在容器中执行本地存储的PnP.PowerShell脚本，无需进入交互模式。

Linux容器

bash
# 将当前目录挂载到容器的/scripts目录，运行脚本script-to-run.ps1
docker run --rm -v ${PWD}:/scripts -w /scripts m365pnp/powershell script-to-run.ps1

Windows容器

PowerShell
# 将当前目录挂载到容器的c:/scripts目录，运行脚本script-to-run.ps1
docker run --rm -v ${PWD}:c:/scripts -w c:/scripts m365pnp/powershell script-to-run.ps1

标签命名规则与架构支持

标签命名规则

镜像标签遵循以下格式：
<version>[-nightly/-stable]-<architecture>

• <version>：模块版本号（如3.1.127），省略时表示最新版。
• -nightly/-stable：可选，指定构建类型（nightly为夜间构建，stable为稳定版），省略时默认稳定版。
• <architecture>：可选，指定硬件架构，省略时自动匹配当前环境架构。

支持的架构

标签示例

版本号获取

模块版本号可通过 PowerShell Gallery 查询。

反馈与支持

如对PnP.PowerShell模块功能或镜像构建有反馈需求，可通过 PnP/PowerShell GitHub仓库 提交issue。