Running multiple versions of PnP-PowerShell

This is by no means new news, as Chris Kent and Erwin van Hunen have already covered how to do this, but I wanted to add my personal notes as someone who already had unintentionally installed multiple versions of PowerShell, through both the .msi install files and the PowerShell gallery because I’m apparently an overachiever.
First, figure out what you have installed:
Get-Module SharePointPnPPowerShell* -ListAvailable | Select-Object Name,Version | Sort-Object Version -Descending
This will list out all the versions of PnP that you have currently have installed. If you have installed multiple versions in the past, you may have multiple versions of even the 2016 or 2013 or Online installed. (My screenshot below looks really clean – I forgot to take a screenshot before, but I had five versions installed before!)

If you have multiple, conflicting versions installed, then run this code below. (If you just have one, then skip down to the next section.) Specify the flavor of PnP-Powershell and the version number to replace the one I’m showing below:
Get-InstalledModule -Name "SharePointPnPPowerShellOnline" -RequiredVersion 3.2.1810.0 | Uninstall-Module
Repeat this as many times as you need to.
Next, install the versions of PnP-PowerShell that you want:
Chris’ article provides a couple options for getting your desired setup. The breakdown is that you can install all three via the Powershell Gallery, which will run 2013 by default. Or, you can just install Online via the Powershell Gallery, save the other two .msi files from the Releases page, and load those manually as needed. Those methods work great if you are starting from scratch, but if you have already installed with .msi files, then you will need the additional step of removing the environment variables. Here’s what I did, step by step, to install with Chris’ first method.

    1. Be sure you’re running Powershell as an administrator.
    2. You might find it easier just to uninstall ALL versions of Powershell, using the above approach.
    3. Open Control Panel > System Properties > Advanced tab and click Environment Variables.
    4. Look for the PSMODULEPATH variable, click it to select it, and delete it.
    5. At this point, you can follow Chris’ instructions to install with your desired method. I used the first method, so I installed all three flavors of PnP-PowerShell with these commands:
      Install-Module SharePointPnPPowerShell2013
      Install-Module SharePointPnPPowerShell2016 -AllowClobber
      Install-Module SharePointPnPPowerShellOnline -AllowClobber
      (The -AllowClobber parameter allows multiple versions to be installed.)
    6. At this point, I can run from 2013 by default, or choose which flavor I want to use when I first start my Powershell session, by using the commands:
      Import-Module SharePointPnPPowerShell2016
      Import-Module SharePointPnPPowerShellOnline
      (You’ll see a warning message, which means it’s loaded just fine!)

One more tip, which I found helpful — you can always run Get-Module and see which module you’re running:

Corrie Haffly
Senior Web Developer
Sea Otter Enthusiast
Your SharePoint Tour Guide

Leave a Comment

Your email address will not be published. Required fields are marked *

Enter Code *

Filed Under


Are you preparing to launch a new #SharePoint intranet?

Don’t spring it on employees out of the blue. First, talk to as many of them as you can.

Planning is just phase one. For all of our tips, watch our recent webinar!

It's that time again! Join #Microsoft MVP & Regional Director, @EricOverfield on Thursday, October 28th, at 11:00 AM PST as he walks through #MicrosoftViva’s current state & offerings and what they mean to your #digitalworkspace right now.

It's the final countdown! Join @EricOverfield at 11am PST to learn about common pitfalls and paths to success when moving to #SharePointOnline. You'll walk away with practical tips to use in your organization today!

In today's episode of the #PixelMillWebinars, you'll learn from the experience of a global organization’s path to digital teamwork victory and get to see first-hand how to successfully plan a smooth migration for your team.

Join us at 11am PST!

It's the day of the show y'all! Join #Microsoft RD +MVP @EricOverfield at 11am PST as we walk you through a multi-national enterprise software company’s migration journey to #SharePointOnline. Learn about common pitfalls and paths to success.

Subscribe to PixelMill's

* indicates required

Let's Talk Digital
Workspaces Today

Get In Touch