Reporting Services SharePoint 模式的 PowerShell Cmdlet

當您安裝 SQL Server 2014 Reporting Services SharePoint 模式時，會安裝 PowerShell Cmdlet 以支援 SharePoint 模式中的報表伺服器。 這些指令程式涵蓋三個功能類別。

• 安裝 Reporting Services SharePoint 共用服務和 Proxy。

• 佈建和管理 Reporting Services 服務應用程式和相關聯 Proxy。

• 管理 Reporting Services 功能，例如延伸模組和加密金鑰。

本主題包含下列內容：

• Cmdlet 摘要

• 共用服務和 Proxy Cmdlet

• 服務應用程式和 Proxy Cmdlet

• Reporting Services自訂功能 Cmdlet

• 基本範例

• 詳細範例

  • 建立Reporting Services服務應用程式和 Proxy

  • 檢閱並更新Reporting Services傳遞延伸模組

  • 取得並設定 Reporting Services 應用程式資料庫的屬性，例如資料庫逾時

  • 列出 Reporting Services 資料延伸模組 - SharePoint 模式

  • 變更並列出訂閱擁有者

指令程式摘要

若要執行指令程式，您需要開啟 SharePoint 管理命令介面。 您也可以使用 Microsoft Windows 隨附的圖形化使用者介面編輯器 Windows PowerShell 整合式指令碼環境 (ISE) 。 如需詳細資訊，請參閱 Starting Windows PowerShell on Windows Server。 在下列 Cmdlet 摘要中，服務應用程式「資料庫」參考是指 Reporting Services 服務應用程式建立和使用的所有資料庫。 其中包括組態、警示和暫時資料庫。

當您輸入 PowerShell 範例時，將會看到類似下面的錯誤訊息：

• Install-SPRSService：'Install-SPRSService' 一詞無法辨識為
  Cmdlet、函數、指令檔或可執行程式的名稱。 請檢查名稱拼字，如果名稱含有路徑，請確認路徑正確，然後再試一次。

發生以下其中一個問題：

• Reporting Services SharePoint 模式未安裝，因此 Reporting Services Cmdlet 也未安裝。

• 您已在 Windows PowerShell 或 Windows PowerShell ISE 中執行 PowerShell 命令，而不是在 SharePoint 管理命令介面中執行。 使用 SharePoint 管理命令介面，或是透過以下命令將 SharePoint 嵌入式管理單元加入至 Windows PowerShell 視窗：

  Add-PSSnapin Microsoft.SharePoint.PowerShell  
  

如需詳細資訊，請參閱使用 Windows PowerShell 管理 SharePoint 2013 () https://technet.microsoft.com/library/ee806878.aspx 。

若要開啟 SharePoint 管理命令介面並執行指令程式

1. 按一下 [開始] 按鈕

2. 按一下 [Microsoft SharePoint 產品] 群組。

3. 按一下 [SharePoint 管理命令介面] 。

若要檢視 Cmdlet 的命令列說明，請在 PowerShell 命令提示字元中使用 PowerShell 'Get-Help' 命令。 例如：

Get-Help Get-SPRSServiceApplicationServers

共用服務和 Proxy 指令程式

下表包含用於 Reporting Services SharePoint 共用服務的 PowerShell Cmdlet。

服務應用程式和 Proxy 指令程式

下表包含用於 Reporting Services 服務應用程式及其相關聯 Proxy 的 PowerShell Cmdlet。

Reporting Services 自訂功能指令程式

基本範例

傳回名稱中包含 'SPRS' 的 Cmdlet 清單。 這會是完整的 Reporting Services Cmdlet 清單。

Get-command -noun *SPRS*  

或者透過更詳細的資訊，傳送到名為 commandlist.txt 的文字檔

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

安裝 Reporting Services SharePoint 服務和服務 Proxy。

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 服務應用程式和 Proxy

這個範例指令碼會完成下列工作：

1. 建立 Reporting Services 服務應用程式和 Proxy。 此指令碼會假設應用程式集區 "My App Pool" 已存在。

2. 將 Proxy 加入至預設 Proxy 群組。

3. 將服務應用程式存取權授與連接埠 80 Web 應用程式的內容資料庫。 腳本假設網站 「 http://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 "http://sitename"  
$appPoolAccountName = $appPool.ProcessAccount.LookupName()  
$webApp.GrantAccessToProcessIdentity($appPoolAccountName)

檢閱及更新 Reporting Services 傳遞延伸模組

下列 PowerShell 指令碼範例會更新服務應用程式 My RS Service App之報表伺服器電子郵件傳遞延伸模組的組態。 更新 SMTP 伺服器 (<email server name>) 和 FROM 電子郵件別名 (<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 應用程式」傳回報表伺服器電子郵件傳遞延伸模組的目前設定值。 第一個步驟是將變數 $app 的值設定為名稱為 "My RS Service App" 之服務應用程式的物件。

第二個陳述式將取得變數 $app 中服務應用程式物件的「報表伺服器電子郵件」傳遞延伸模組，並且選取 configurationXML

$app = Get-SPRSServiceapplication -Name "Reporting Services Application"  
Get-SPRSExtension -Identity $app -ExtensionType "Delivery" -Name "Report Server Email" | Select -ExpandProperty ConfigurationXml  

您也可以將上述兩個陳述式重新撰寫成一個：

Get-SPRSServiceApplication -Name "Reporting Services Application" | Get-SPRSExtension -ExtensionType "Delivery" -Name "Report Server Email" | Select -ExpandProperty ConfigurationXml  

取得並設定 Reporting Services 應用程式資料庫的屬性，例如資料庫逾時

下列範例一開始傳回資料庫與屬性的清單，您可以用來決定之後提供給 set 命令的資料庫 GUID (識別碼)。 如需屬性的完整清單，請使用 Get-SPRSDatabase | format-list。

Get-SPRSDatabase | Select id, querytimeout,connectiontimeout, status, server, ServiceInstance

以下是輸出的範例。 決定您要修改之資料庫的識別碼，並在 SET Cmdlet 中使用該識別碼。

• 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 Cmdlet。

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

列出 Reporting Services 資料延伸模組 - SharePoint 模式

下列範例會在每一個 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

變更並列出訂閱擁有者

請參閱使用 PowerShell 變更和列出Reporting Services訂用帳戶擁有者並執行訂用帳戶。

另請參閱

使用 PowerShell 變更及列出 Reporting Services 訂閱擁有者並執行訂閱
檢查清單：使用 PowerShell 驗證 PowerPivot for SharePoint
CodePlex SharePoint Management PowerShell 指令碼