Reporting Services SharePoint モード用の PowerShell コマンドレット

適用対象: SQL Server Reporting Services (2016) SharePoint ❌ Power BI Report Server

以前のバージョンの SQL Server Reporting Services (SSRS) に関するコンテンツについては、「What is SQL Server Reporting Services?」をご覧ください。

SQL Server 2016 Reporting Services SharePoint モードをインストールすると、SharePoint モードのレポート サーバーをサポートするために PowerShell コマンドレットがインストールされます。 コマンドレットは 3 つのカテゴリの機能をサポートしています。

• Reporting Services SharePoint 共有サービスおよびプロキシのインストール。

• Reporting Services サービス アプリケーションおよび関連付けられたプロキシのプロビジョニングと管理。

• Reporting Services 機能 (拡張機能や暗号化キーなど) の管理。

コマンドレットの概要

コマンドレットを実行するには、SharePoint 管理シェルを開く必要があります。 Microsoft Windows に付属しているグラフィカル ユーザー インターフェイス エディター ( Windows PowerShell Integrated Scripting Environment (ISE) ) を使用することもできます。 詳細については、「 Windows Server での Windows PowerShell の開始) を使用することもできます。 次のコマンドレット概要では、サービス アプリケーション "データベース" への参照は、Reporting Services サービス アプリケーションによって作成および使用されたすべてのデータベースを参照します。 これには、構成、警告、および一時データベースが含まれます。

PowerShell の例を入力すると、次のようなエラー メッセージが表示されます。

• Install-SPRSService : 用語 'Install-SPRSService' は、
  コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。 名前が正しく記述されていることを確認し、パスが含まれている場合はそのパスが正しいことを確認してから、再試行してください。

次のいずれかの問題が発生しています。

• Reporting Services SharePoint モードがインストールされていないため、Reporting Services コマンドレットはインストールされません。

• SharePoint 管理シェルでなく、Windows PowerShell または Windows PowerShell ISE で PowerShell コマンドを実行しました。 SharePoint 管理シェルを使用するか、次のコマンドで SharePoint スナップインを Windows PowerShell ウィンドウに追加します。

  Add-PSSnapin Microsoft.SharePoint.PowerShell  
  

詳細については、「Windows PowerShell を使用して SharePoint 2013 を管理する」をご覧ください。

SharePoint 管理シェルを開いてコマンドレットを実行する

1. [スタート] ボタンを選びます。

2. [Microsoft SharePoint 製品] グループを選択します。

3. SharePoint 管理シェルを選択します。

コマンドレットのコマンド ライン ヘルプを表示するには、PowerShell のコマンド プロンプトで 'Get-Help' コマンドを使用します。 次に例を示します。

Get-Help Get-SPRSServiceApplicationServers

共有サービスとプロキシ コマンドレット

次の表に、Reporting Services SharePoint 共有サービス用の PowerShell コマンドレットを示します。

サービス アプリケーションとプロキシ コマンドレット

次の表には、Reporting Services サービス アプリケーションとそれらに関連付けられたプロキシ用の PowerShell コマンドレットが含まれています。

Reporting Services カスタム機能コマンドレット

基本的なサンプル

名前に 'SPRS' を含んでいるコマンドレットの一覧を返します。 この一覧には Reporting Services コマンドレットの完全な一覧を示しています。

Get-command -noun *SPRS*  

または、より詳細な情報を使用して、commandlist.txt という名前のテキスト ファイルにパイプします。

Get-command -noun *SPRS* | Select name, definition | Format-List | Out-File c:\commandlist.txt  

Reporting Services SharePoint サービスおよびサービス プロキシをインストールします。

Install-SPRSService  

Install-SPRSServiceProxy  

Reporting Services サービスを開始します。

get-spserviceinstance -all |where {$_.TypeName -like "SQL Server Reporting*"} | Start-SPServiceInstance  

SharePoint 管理シェルから次のコマンドを入力すると、ログ ファイルからフィルター処理された行のリストが返されます。 このコマンドは、"ssrscustomactionerror" を含む行がフィルター処理します。 この例では、rssharepoint.msi のインストール時に作成されたログ ファイルが検索対象となっています。

Get-content -path C:\Users\testuser\AppData\Local\Temp\rs_sp_0.log | select-string "ssrscustomactionerror"  

詳細なサンプル

次のサンプルに加えて、「手順 1 - 4 に対応する Windows PowerShell スクリプト」記事内の「Windows PowerShell スクリプト」を参照してください。

Reporting Services サービス アプリケーションとプロキシの作成

このサンプル スクリプトは次のタスクを完了します。

1. Reporting Services サービス アプリケーションとプロキシを作成する。 このスクリプトは、"My App Pool" というアプリケーション プールが既に存在することを前提としています。

2. 作成したプロキシを既定のプロキシ グループに追加する。

3. ポート 80 の Web アプリケーションのコンテンツ データベースに、サービス アプリケーション アクセス権を付与する。 このスクリプトは、サイト https://sitename が既に存在することを前提としています。

# Create service application and service application proxy  
$appPool = Get-SPServiceApplicationPool "My App Pool"  
$serviceApp = New-SPRSServiceApplication "My RS Service App" -ApplicationPool $appPool  
$serviceAppProxy = New-SPRSServiceApplicationProxy -Name "My RS Service App Proxy" -ServiceApplication $serviceApp  
  
# Add service application proxy to default proxy group.  Any web application that uses the default proxy group will now be able to use this service application.  
Get-SPServiceApplicationProxyGroup -default | Add-SPServiceApplicationProxyGroupMember -Member $serviceAppProxy  
  
# Grant application pool account access to the port 80 web application's content database.  
$webApp = Get-SPWebApplication "https://sitename"  
$appPoolAccountName = $appPool.ProcessAccount.LookupName()  
$webApp.GrantAccessToProcessIdentity($appPoolAccountName)  
  

Reporting Services 配信拡張機能の確認と更新

次の PowerShell スクリプトの例では、My RS Service App という名前のサービス アプリケーションについて、レポート サーバーの電子メール配信拡張機能の構成を更新します。 SMTP サーバー (<email server name>) と差出人の電子メール別名 (<your FROM email address>) の値を更新します。

$app=get-sprsserviceapplication -Name "My RS Service App"  
$emailCfg = Get-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml   
$emailXml = [xml]$emailCfg   
$emailXml.SelectSingleNode("//SMTPServer").InnerText = "<email server name>"  
$emailXml.SelectSingleNode("//SendUsing").InnerText = "2"  
$emailXml.SelectSingleNode("//SMTPAuthenticate").InnerText = "2"  
$emailXml.SelectSingleNode("//From").InnerText = '<your FROM email address>'  
Set-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" -ExtensionConfiguration $emailXml.OuterXml  

上の例で、サービス アプリケーションの正確な名前がわからない場合は、最初のステートメントを書き換えて、サービス アプリケーションを部分名検索に基づいて取得することもできます。 次に例を示します。

$app=get-sprsserviceapplication | where {$_.name -like " ssrs_testapp *"}  

次のスクリプトは、"Reporting Services Application" という名前のサービス アプリケーションのレポート サーバー電子メール配信拡張機能の現在の構成値を返します。最初の手順では、変数 $app の値を、"My RS Service App" という名前のサービス アプリケーションのオブジェクトに設定します。

2 番目のステートメントは、変数 $app 内のサービス アプリケーション オブジェクト用の "レポート サーバー メール" 配信拡張機能を取得し、configurationXML を選択します。

$app=get-sprsserviceapplication -Name "Reporting Services Application"  
Get-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml  

前述の 2 つのステートメントを次のように書き直して 1 つのステートメントにすることもできます。

get-sprsserviceapplication -Name "Reporting Services Application" | Get-SPRSExtension -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml  

Reporting Service アプリケーション データベースのプロパティの取得と設定

次の例では、set コマンドに指定するデータベースの GUID (ID) を確認できるように、最初にデータベースとプロパティの一覧を返します。 プロパティの一覧については、「 Get-SPRSDatabase | format-list」を参照してください。

get-SPRSDatabase | select id, querytimeout,connectiontimeout, status, server, ServiceInstance   

次の出力は例です。 変更するデータベースの ID を確認し、SET コマンドレットでその ID を使用します。

• Id : 56f8d1bc-cb04-44cf-bd41-a873643c5a14

  QueryTimeout : 120

  ConnectionTimeout : 15

  Status : Online

  Server : SPServer Name=uetestb01

  ServiceInstance : SPDatabaseServiceInstance

Set-SPRSDatabase -identity 56f8d1bc-cb04-44cf-bd41-a873643c5a14 -QueryTimeout 300  

値が設定されていることを確認するには、もう一度 GET コマンドレットを実行します。

Get-SPRSDatabase -identity 56f8d1bc-cb04-44cf-bd41-a873643c5a14 | select id, querytimeout,connectiontimeout, status, server, ServiceInstance  

Reporting Services データ拡張機能の一覧表示

次の例では、各 Reporting Services サービス アプリケーションの間をループし、それぞれの現在のデータ拡張機能を一覧表示します。

$apps = Get-SPRSServiceApplication  
foreach ($app in $apps)   
{  
Write-host -ForegroundColor "yellow" Service App Name $app.Name  
Get-SPRSExtension -identity $app -ExtensionType "Data" | select name,extensiontype | Format-Table -AutoSize  
}  

出力例:

• Name ExtensionType

  ---- -------------

  SQL Data

  SQLAZURE Data

  SQLPDW Data

  OLEDB Data

  OLEDB-MD Data

  ORACLE Data

  ODBC Data

  XML Data

  SHAREPOINTLIST Data

Reporting Services サブスクリプション所有者の変更と一覧表示

「PowerShell を使用した Reporting Services サブスクリプション所有者の変更および一覧表示とサブスクリプションの実行」を参照してください。

関連するコンテンツ

• PowerShell を使用した Reporting Services サブスクリプション所有者の変更および一覧表示とサブスクリプションの実行
• チェックリスト:PowerShell を使用して Power Pivot for SharePoint を確認する
• SQL Server PowerShell のヘルプの参照
• Reporting Services のフォーラムに質問してみてください