PowerShell 指令程式 (Reporting Services SharePoint 模式)

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

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

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

• 管理 Reporting Services 功能，例如擴充功能和加密金鑰。

本主題包含下列內容：

• Cmdlet Summary

• Shared Service Cmdlets

• Service Application Cmdlets

• Reporting Services functionality related Cmdlets

• Basic Samples

• Detailed Samples

  • Create a service application and proxy

  • Review and update a delivery extension

  • Get and set Properties of the Reporting Service Application Database

  • List Data Extensions

  • Change and list subscription owners

指令程式摘要

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

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

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

發生下列其中一個問題：

• Reporting Services SharePoint 模式未安裝，因此 Reporting Services 指令程式也未安裝。

• 您已在 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 管理命令介面]。

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

Get-Help Get-SPRSServiceApplicationServers

Top

共用服務和 Proxy 指令程式

下表包含用於 Reporting Services SharePoint 共用服務的 PowerShell 指令程式。

Top

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

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

Top

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 服務和服務 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"

Top

詳細範例

除以下範例之外，請參閱主題(Steps 1-4) Windows PowerShell script for Steps 1–4中的＜Windows PowerShell 指令碼＞一節。

建立服務應用程式和 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)

檢閱及更新傳遞延伸模組

下列 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 " My RS Ser *"}

下列指令碼將傳回服務應用程式 “My RS Service App” 之報表伺服器電子郵件傳遞延伸模組目前的組態值。 第一個步驟是將變數 $app 的值設定為名稱 "My RS Service App" 之服務應用程式的物件。

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

$app=get-sprsserviceapplication –Name "My RS Service App"
Get-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml

Top

取得及設定報表服務應用程式資料庫的屬性

下列範例會先傳回資料庫與屬性的清單，如此您可以判斷您之後提供給 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

Top

清單資料延伸模組

以下範例會經過每個 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

Top

變更並列出訂閱擁有者

請參閱＜Use PowerShell to Change and List Reporting Services Subscription Owners and Run a Subscription＞。

Top

請參閱

概念

Use PowerShell to Change and List Reporting Services Subscription Owners and Run a Subscription

取得 SQL Server PowerShell 說明

其他資源

CodePlex SharePoint Management PowerShell 指令碼

如何使用 PowerShell 管理 SSRS