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


It's webinar week! Join the #PixelMillWebinars on Thursday at 11am PST when our friends @HKSArchitects join us to showcass the success story of three librarians breaking free from their intranet-in-a-box solution.

Key information is often siloed in a corporate intranet, limiting your teams' resources. Join 3 knowledge managers as they walk through building a knowledge center that delivers a modular, silo-busting learning experience with out-of-the-box #SharePoint.

Three librarians walk into an #intranet—all jokes aside, our next webinar showcases the success story of 3 librarians breaking free from their intranet-in-a-box & creating an intuitive resource for their global team with out-of-the-box #SharePoint.

Intranet-in-a-box solutions work for some, but our client felt limited by their solution. Join our next webinar as a global architecture firm shares its journey from intranet-in-a-box to a sustainable, maintainable solution with out-of-the-box #SharePoint

Has your intranet solution left you feeling locked in while limiting your capabilities? Join our webinar where our client shows how they broke out of the box using #outofthebox #SharePoint & delivered a successful solution for their 1300 global employees

Subscribe to PixelMill's

* indicates required

Let's Talk Digital
Workspaces Today

Get In Touch