SharePoint Server コマンドレットの一覧については、「 Microsoft.SharePoint.Powershell コマンドレット」を参照してください。
SharePoint Server 向けの PowerShell にアクセスする
SharePoint Server のインストール後は、SharePoint 2016 管理シェル で PowerShell のコマンドレットを利用できます。 SharePoint 管理シェル では、SharePoint Server の多くの部分を管理できます。 新しいサイト コレクション、Web アプリケーション、ユーザー アカウント、サービス アプリケーション、プロキシなどを作成できます。 SharePoint 管理シェルでコマンドを入力すると、Microsoft .NET Framework に基づいた SharePoint オブジェクトが返されます。 それらのオブジェクトは、後続のコマンドへの入力として適用したり、後で使用できるようにローカル変数に格納することができます。
SharePoint 管理シェルでは、コマンドレットを含むスナップインを登録する必要はありません。 登録は、SharePoint.ps1 ファイルのAdd-PSSnapin Microsoft.SharePoint.PowerShell行によって処理されます。 このファイルは、 %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\<version>\Config\PowerShell\Registration フォルダーにあります。
-
<version>15 が SharePoint Server 2013 と等しい -
<version>16 が SharePoint Server 2016 と等しい
PowerShell コンソールを使用する場合は、このスナップインを手動で登録する必要があります。
SharePoint 管理シェルと PowerShell コンソールのどちらを使用する場合でも、追加のスナップインとモジュールを読み込むこともできます。
注:
SharePoint 管理シェルと PowerShell コンソールでは、スレッド モデルの使用方法を定義する ReuseThread オプションの使用も異なります。 SharePoint 管理シェルの使用は、SharePoint.ps1 ファイル内のこの行 ({Host.Runspace.ThreadOptions = "ReuseThread"}) によって定義されます。 詳細については、「PS Thread Options (PS スレッド オプション)」を参照してください。
アクセス許可
Add-SPShellAdmin コマンドレットを使用して、ユーザーが SharePoint Server コマンドレットを実行するためのアクセス許可を付与する前に、次のすべての最小要件を満たしていることを確認します。
- SQL Server インスタンスの SecurityAdmin 固定サーバー ロールにメンバーシップが必要です。
- PowerShell コマンドレットを実行するサーバーの Administrators グループのメンバーである必要があります。
注:
これらの権限がない場合は、セットアップ管理者または SQL Server 管理者に連絡して、これらの権限を要求してください。
PowerShell のアクセス許可に関する詳細については、「Add-SPShellAdmin」を参照してください。
SharePoint_Shell_Access ロールのメンバーシップがない場合、またはローカル グループWSS_Admin_WPG場合は、Add-SPShellAdmin コマンドレットを使用して、SharePoint ファーム内のすべてのフロントエンド Web サーバーとSharePoint_Shell_Access ロールにWSS_Admin_WPG グループを追加します。 SQL Server データベースにSharePoint_Shell_Accessロールがない場合、Add-SPShellAdmin コマンドレットを実行するとロールが自動的に作成されます。
Add-SPShellAdmin コマンドレットを実行すると、ユーザーは複数サーバー ファーム環境で SharePoint PowerShell コマンドレットを実行できます。
注:
SharePoint Serverをインストールすると、インストールを実行するユーザー アカウントに PowerShell のコマンドレットを実行するための適切な権限が付与されます。 PowerShell コマンドレットを実行するためにユーザーが追加されていない場合は、 Add-SPShellAdmin コマンドレットを使用して追加できます。
すべての SPShellAdmin コマンドレットの一覧を表示するには、PowerShell コマンド プロンプトから「 Get-Command -Noun SPShellAdmin」と入力します。
スクリプトと実行ポリシー
Microsoft PowerShell では単一の管理タスクを実行できますが、スクリプトを使用して一連のタスクを自動化することもできます。 スクリプトは、1 つ以上の Microsoft PowerShell コマンドが含まれるテキスト ファイルです。 Microsoft PowerShell スクリプトには、 .ps1 ファイル名拡張子があります。
スクリプトを実行するには、SharePoint Server に最低限必要な実行ポリシーは RemoteSigned ですが、PowerShell の既定のポリシーは [制限付き] です。 ポリシーが [制限付き] のままにされている場合、SharePoint 管理シェルは PowerShell のポリシーを RemoteSigned に変更します。 つまり、管理者特権の管理アクセス許可を持つ SharePoint 管理シェルを開始するには、管理者として実行を選択する必要があります。 この変更は、すべての PowerShell セッションに適用されます。 スクリプトと実行ポリシーの詳細については、「 about_scripts 」および「 実行ポリシーについて」を参照してください。