🐨

最新バージョンの PnP PowerShell のインストールについて

2022/03/01に公開

はじめに

この記事では、PnP PowerShell のインストール手順について説明します。
PnP PowerShell は、バージョンによってサポートされる PowerShell のバージョンが異なります。

最新のバージョンである PnP PowerShell 2.xx 系は、PowerShell 7.2 以上で動作します。
Windows PowerShell 5.1 の場合は、1.xx 系の PnP PowerShell を明示的にしてインストールを行う必要があります。
本記事では、これらを考慮したインストール手順を説明します。
バージョンについての説明は、github 上の PnP PowerShell のページに記載があります。

https://github.com/pnp/powershell

PnP PowerShell のインストール方法

PowerShell 7.2 以上を利用しているユーザーは、以下のコマンドを実行することで、安定版の最新バージョンの PnP PowerShell をインストールし、利用することができます。

PowerShell を管理者として実行し、コマンドを実行します。

Install-Module -Name "PnP.PowerShell"

Windows PowerShell 5.1 を利用しているユーザーは、最初の説明の通り、最新の 2.xx 系を利用できないため、以下のように 1.xx 系のバージョンを指定して、インストールを行うが必要があります。

Install-Module -Name "PnP.PowerShell"  -RequiredVersion 1.12.0 

その他のバージョンのインストールについては、下記の PowerShell ギャラリーの内容を参考にバージョンを指定したインストールを行うことができます。
https://www.powershellgallery.com/packages/PnP.PowerShell/

インストールの詳細とインストール後の設定の詳細は、下記の記事に記載されています。

https://pnp.github.io/powershell/articles/installation.html

https://pnp.github.io/powershell/articles/authentication.html

従来のバージョンの PnP PowerShell (SharePointPnPPowerShellOnline) について

PnP PowerShell には、従来のバージョンの PnP PowerShell (SharePointPnPPowerShellOnline) があります。

以下のコマンドからインストールが可能ですが、こちらのバージョンに関しては、今後メンテナンスの予定はなく、現在はアーカイブの状況とのことです。
また、コミュニティでもサポートが提供されないため、上述の最新の PnP PowerShell の利用が強く推奨されています。

Install-Module -Name "SharePointPnPPowerShellOnline" 

https://github.com/pnp/PnP-PowerShell

PnP-PowerShell Repository - ARCHIVED Important: PnP-PowerShell has been retired and archived. Move to the new PnP PowerShell module available at https://github.com/pnp/powershell. We will only maintain that version going forward.

従来バージョンの PnP PowerShell (SharePointPnPPowerShellOnline) から、最新の PnP PowerShell (PnP.PoweShell) へのアップグレードの手順やバージョン変更の詳細ついては、以下の記事にまとまっています。

https://pnp.github.io/powershell/articles/upgrading.html

Discussion