共用方式為

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 指令程式。

指令程式

描述

Install-SPRSService

安裝及註冊或是解除安裝 Reporting Services 共用服務。 只有在安裝了 SharePoint 模式之 SQL Server Reporting Services 的電腦上才可以執行這項作業。 針對安裝會進行兩項作業：

  1. Reporting Services 服務安裝在伺服器陣列中。

  2. Reporting Services 服務執行個體會安裝到目前的電腦上。

針對解除安裝會進行兩項作業：

  1. Reporting Services 服務會從目前的電腦解除安裝。

  2. Reporting Services 服務會從伺服器陣列解除安裝。

注意：如果伺服器陣列中有任何其他電腦已安裝 Reporting Services 服務，或是伺服器陣列中仍有執行中的 Reporting Services 服務應用程式，就會顯示警告訊息。

Install-SPRSServiceProxy

在 SharePoint 伺服器陣列中安裝及註冊或是解除安裝 Reporting Services 服務 Proxy。

Get-SPRSProxyUrl

取得存取 Reporting Services 服務的 URL。

Get-SPRSServiceApplicationServers

在包含 Reporting Services 共用服務安裝的本機 SharePoint 伺服器陣列中取得所有伺服器。

搭配回到頁首連結使用的箭頭圖示Top

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

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

指令程式

描述

Get-SPRSServiceApplication

取得一個或多個 Reporting Services 服務應用程式。

New-SPRSServiceApplication

建立新的 Reporting Services 服務應用程式與相關聯的資料庫。

LogonType 參數：指定報表伺服器會使用 SSRS 應用程式集區帳戶或是 SQL Server 登入，存取報表伺服器資料庫。 可以是下列其中一項：

  • 0 Windows 驗證

  • 1 SQL Server

  • 2 應用程式集區帳戶 (預設)

Remove-SPRSServiceApplication

移除指定的 Reporting Services 服務應用程式。 這項操作也會移除相關聯的資料庫。

Set-SPRSServiceApplication

編輯現有 Reporting Services 服務應用程式的屬性。

New-SPRSServiceApplicationProxy

建立新的 Reporting Services 服務應用程式 Proxy。

Get-SPRSServiceApplicationProxy

取得一個或多個 Reporting Services 服務應用程式 Proxy。

Dismount-SPRSDatabase

卸載 Reporting Services 服務應用程式的服務應用程式資料庫。

Remove-SPRSDatabase

移除 Reporting Services 服務應用程式的服務應用程式資料庫。

Set-SPRSDatabase

設定與 Reporting Services 服務應用程式相關聯之資料庫的屬性。

Mount-SPRSDatabase

掛接 Reporting Services 服務應用程式的資料庫。

New-SPRSDatabase

為指定的 Reporting Services 服務應用程式建立新的服務應用程式資料庫。

Get-SPRSDatabaseCreationScript

針對 Reporting Services 服務應用程式將資料庫建立指令碼輸出到畫面。 然後您就可以在 SQL Server Management Studio 中執行指令碼。

Get-SPRSDatabase

取得一個或多個 Reporting Services 服務應用程式資料庫。

Get-SPRSDatabaseRightsScript

針對 Reporting Services 服務應用程式將資料庫權限指令碼輸出到畫面。 它會提示您提供所需的使用者和資料庫，然後傳回您可執行以修改權限的 Transact SQL。 然後您就可以在 SQL Server Management Studio 中執行這個指令碼。

Get-SPRSDatabaseUpgradeScript

將資料庫升級指令碼輸出至畫面。 指令碼會將 Reporting Services 服務應用程式資料庫升級至目前 Reporting Services 安裝的資料庫版本。

搭配回到頁首連結使用的箭頭圖示Top

Reporting Services 自訂功能指令程式

指令程式

描述

Update-SPRSEncryptionKey

為指定的 Reporting Services 服務應用程式更新加密金鑰，並重新加密其資料。

Restore-SPRSEncryptionKey

為 Reporting Services 服務應用程式還原之前備份的加密金鑰。

Remove-SPRSEncryptedData

為指定的 Reporting Services 服務應用程式刪除加密的資料。

Backup-SPRSEncryptionKey

為指定的 Reporting Services 服務應用程式備份加密金鑰。

New-SPRSExtension

向 Reporting Services 服務應用程式註冊新的延伸模組。

Set-SPRSExtension

設定現有 Reporting Services 延伸模組的屬性。

Remove-SPRSExtension

從 Reporting Services 服務應用程式中移除延伸模組。

Get-SPRSExtension

獲取一個或多個用於 Reporting Services 服務應用程式的 Reporting Services 延伸模組。

Get-SPRSSite

根據是否啟用 "ReportingService" 功能取得 SharePoint 網站。 根據預設，將會傳回啟用 "ReportingService" 功能的網站。

基本範例

傳回名稱中包含 '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