m365pnp/powershell repository overview

⁠PnP.Powershell

PnP PowerShell is a .NET 8 based PowerShell Module providing nearly 800 cmdlets that work with Microsoft 365 environments such as SharePoint Online, Microsoft Teams, Microsoft Project, Security & Compliance, Entra ID, and more.

⁠Featured tags

⁠Latest

• latest: The latest stable image

  • docker pull m365pnp/powershell or docker pull m365pnp/powershell:latest or docker pull m365pnp/powershell:stable

⁠Nightly

• nightly: The latest nightly build image

  • docker pull m365pnp/powershell:nightly

⁠Usage examples

Starting an isolated container with the latest stable PnP.PowerShell module installed:

docker run --rm -it m365pnp/powershell

Starting a PnP.PowerShell container with the current directory mounted:

⁠Linux Container

docker run --rm -it -v ${PWD}:/home -w /home m365pnp/powershell

⁠Windows Container

docker run --rm -it -v ${PWD}:c:/app -w c:/app m365pnp/powershell

Running a PnP.PowerShell script which is locally stored on your machine in a container unattended:

⁠Linux Container

docker run --rm -v ${PWD}:/scripts -w /scripts m365pnp/powershell script-to-run.ps1

⁠Windows Container

docker run --rm -v ${PWD}:c:/scripts -w c:/scripts m365pnp/powershell script-to-run.ps1

⁠Tag explanation

Tags names mean the following:

<version>[-nightly/-stable]-<architecture>

⁠Currently supported architectures

• linux-amd64⁠: Alpine 64 bits
• windows-amd64⁠: Windows NanoServer LTSC 2025 64 bits
• linux-arm32⁠: .NET SDK 9 32 bits (i.e. Raspberry Pi 2 v1.1 or older running 32 bit Linux)
• linux-arm64⁠: Linux Debian Bullseye Slim 64 bits for ARM devices (i.e. Raspberry Pi 2 v1.2 or later running 64 bit Linux)

Looking for other architectures? Let us know!⁠

⁠Tag name examples

• nightly - auto picks the correct architecture with the latest available nightly build
• stable - auto picks the correct architecture with the latest available stable build (same as latest)
• latest - auto picks the correct architecture with the latest available stable build (same as stable)
• 3.1.127-nightly - auto picks the correct architecture with the 3.1.127 nightly build
• 3.1.127-nightly-windows-amd64 - forces the Windows 64 bit architecture with the 3.1.127 nightly build
• 3.1.0-stable - auto picks the correct architecture with the 3.1.0 stable build
• 3.1.0-stable-linux-amd64 - forces the Linux 64 bit architecture with the 3.1.0 stable build

⁠Version numbers

To find the version numbers please visit https://www.powershellgallery.com/packages/PnP.PowerShell⁠

⁠Feedback

To give feedback for PnP.PowerShell or for how the images are built, file an issue at PnP/PowerShell⁠