SharePoint Server コマンドレットの一覧については、「SharePoint Server コマンドレット」を参照してください。
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 です。
PowerShell の既定のポリシーは Restricted ですが、スクリプトを実行するために SharePoint Server に最低限必要な実行ポリシーは RemoteSigned です。 ポリシーが [制限付き] のままの場合、SharePoint 管理シェルは PowerShell のポリシーを RemoteSigned に変更します。 つまり、管理者特権の管理アクセス許可を持つ SharePoint 管理シェルを開始するには、管理者として実行を選択する必要があります。 この変更は、すべての PowerShell セッションに適用されます。 スクリプトと実行ポリシーの詳細については、「 about_scripts 」および「 実行ポリシーについて」を参照してください。