PowerShell-Cmdlets für SharePoint-Modus von Reporting Services

Wenn Sie SQL Server 2014 Reporting Services SharePoint-Modus installieren, werden PowerShell-Cmdlets installiert, um Berichtsserver im SharePoint-Modus zu unterstützen. Die Cmdlets decken drei Funktionalitätskategorien ab.

• Installation des gemeinsamen SharePoint-Diensts und -Proxys von Reporting Services.

• Bereitstellung und Verwaltung von Reporting Services-Dienstanwendungen und zugeordneten Proxys.

• Verwaltung von Reporting Services-Funktionen wie Erweiterungen und Verschlüsselungsschlüssel.

Dieses Thema enthält Folgendes:

• Cmdletzusammenfassung

• Shared Service- und Proxy-Cmdlets

• Dienstanwendungs- und Proxy-Cmdlets

• Reporting Services Cmdlets für benutzerdefinierte Funktionen

• Grundlegende Beispiele

• Detaillierte Beispiele

  • Erstellen einer Reporting Services Dienstanwendung und eines Proxys

  • Überprüfen und Aktualisieren einer Reporting Services Übermittlungserweiterung

  • Abrufen und Festlegen von Eigenschaften der Reporting Services-Anwendungsdatenbank, z. B. Timeout der Datenbank

  • Auflisten von Reporting Services-Datenerweiterungen – SharePoint-Modus

  • Ändern und Aufführen von Abonnementbesitzern

Cmdlet-Zusammenfassung

Um die Cmdlets auszuführen, müssen Sie die SharePoint-Verwaltungsshell öffnen. Sie können auch den Editor für grafische Benutzeroberflächen Windows PowerShell Integrated Scripting Environment (ISE) verwenden, der in Microsoft Windows enthalten ist. Weitere Informationen finden Sie unter Starting Windows PowerShell on Windows Serververwenden, der in Microsoft Windows enthalten ist. In den folgenden Zusammenfassungen von Cmdlets wird mit den Verweisen auf die Dienstanwendung „Databases“ auf sämtliche mit einer Reporting Services-Dienstanwendung erstellten und von ihr verwendeten Datenbanken verwiesen. Dies schließt die Konfigurations- und Warnungsdatenbanken sowie temporären Datenbanken ein.

Wenn Sie bei der Eingabe der PowerShell-Beispiele eine Fehlermeldung mit etwa folgendem Wortlaut sehen:

• Install-SPRSService: Die Benennung „Install-SPRSService“ wurde nicht als
  Name eines Cmdlets, einer Funktion, einer Skriptdatei oder eines ausführbaren Programms erkannt. Prüfen Sie die Schreibweise des Namens bzw. stellen Sie sicher, dass der Pfad korrekt angegeben wurde, und versuchen Sie es erneut.

Eines der folgenden Probleme tritt auf:

• Der SharePoint-Modus von Reporting Services ist nicht installiert, weshalb auch die Reporting Services-Cmdlets nicht installiert sind.

• Sie haben den PowerShell-Befehl in Windows PowerShell oder Windows PowerShell ISE statt in der SharePoint-Verwaltungsshell ausgeführt. Verwenden Sie die SharePoint-Verwaltungsshell, oder fügen Sie dem Windows PowerShell-Fenster mithilfe des folgenden Befehls das SharePoint-Snap-In hinzu:

  Add-PSSnapin Microsoft.SharePoint.PowerShell  
  

Weitere Informationen finden Sie unter Verwenden Windows PowerShell zum Verwalten von SharePoint 2013 (https://technet.microsoft.com/library/ee806878.aspx).

So öffnen Sie die SharePoint-Verwaltungsshell und führen Cmdlets aus

1. Klicken Sie auf die Schaltfläche Start .

2. Klicken Sie auf die Gruppe Microsoft SharePoint-Produkte .

3. Klicken Sie auf SharePoint-Verwaltungsshell.

Um die Befehlszeilenhilfe für ein Cmdlet anzuzeigen, verwenden Sie in der PowerShell-Eingabeaufforderung den PowerShell-Befehl „Get-Help“. Beispiel:

Get-Help Get-SPRSServiceApplicationServers

Shared Service- und Proxy-Cmdlets

Die folgende Tabelle enthält die PowerShell-Cmdlets für den freigegebenen SharePoint-Dienst für Reporting Services.

Dienstanwendungs- und Proxy-Cmdlets

Die folgende Tabelle enthält die PowerShell-Cmdlets für Reporting Services-Dienstanwendungen und ihre zugeordneten Proxys.

Benutzerdefinierte Reporting Services-Funktionalitäts-Cmdlets

Basisbeispiele

Gibt eine Liste von Cmdlets zurück, die „SPRS“ im Namen enthalten. Diese Liste enthält sämtliche Reporting Services-Cmdlets.

Get-command -noun *SPRS*  

Alternativ erfolgt die Weiterleitung an eine Textdatei namens "commandlist.txt" mit genaueren Details.

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

Installieren Sie den Reporting Services-SharePoint-Dienst und den -Dienstproxy.

Install-SPRSService  

Install-SPRSServiceProxy  

Starten Sie den Reporting Services-Dienst

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

Geben Sie den folgenden Befehl in der SharePoint-Verwaltungsshell ein, um eine gefilterte Zeilenliste aus der Protokolldatei abzurufen. Durch den Befehl werden Zeilen herausgefiltert, die „ssrscustomactionerror“ enthalten. Dieses Beispiel bezieht sich auf die Protokolldatei, die bei der Installation von "rssharepoint.msi" erstellt wurde.

Get-Content -Path C:\Users\testuser\AppData\Local\Temp\rs_sp_0.log | Select-String "ssrscustomactionerror"  

Ausführliche Beispiele

Zusätzlich zu den folgenden Beispielen finden Sie weitere Beispiele im Abschnitt „Windows PowerShell-Skript“ unter dem Thema Windows PowerShell-Skript für die Schritte 1 bis 4.

Erstellen einer Reporting Services-Dienstanwendung und eines entsprechenden Proxys

Dieses Beispielskript führt die folgenden Tasks aus:

1. Erstellt eine Reporting Services-Dienstanwendung und einen entsprechenden Proxy. Das Skript geht davon aus, dass der Anwendungspool „Mein Anwendungspool“ bereits vorhanden ist.

2. Hinzufügen des Proxys zur Standardproxygruppe

3. Gewähren Sie der Dienstanwendung Zugriff auf die Inhaltsdatenbank der Webanwendung (Port 80). Das Skript geht davon aus, dass website "http://sitename" ist bereits vorhanden.

# 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)

Überprüfen und Aktualisieren einer Reporting Services-Übermittlungserweiterung

Das folgende PowerShell-Skript-Beispiel aktualisiert die Konfiguration der Berichtsserver-E-Mail-Übermittlungserweiterung für die Dienstanwendung mit dem Namen My RS Service App. Aktualisieren Sie die Werte für den SMTP-Server (<email server name>) und für den E-Mail-Absenderalias „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  

Wenn Sie im oben genannten Beispiel den genauen Namen der Dienstanwendung nicht kennen, besteht die Möglichkeit, die erste Anweisung umzuschreiben, um die Dienstanwendung auf Grundlage einer Suche nach dem Teilnamen abzurufen. Beispiel:

$app = Get-SPRSServiceApplication | Where {$_.name -like " ssrs_testapp *"}  

Das folgende Skript gibt die aktuellen Konfigurationswerte für die Berichtsserver-E-Mail-Übermittlungserweiterung der Dienstanwendung namens „Reporting Services-Anwendung“ zurück. Im ersten Schritt wird der Wert der Variablen $app auf das Objekt der Dienstanwendung mit dem Namen "Meine RS-Dienstanwendung" festgelegt.

Die zweite Anweisung ruft die Übermittlungserweiterung „Berichtsserver-E-Mail“ für das Dienstanwendungsobjekt in der Variablen $app ab und wählt configurationXML aus.

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

Sie können die beiden oben stehenden Anweisungen auch in einer Anweisung zusammenfassen:

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

Abrufen und Festlegen von Eigenschaften der Reporting Services-Anwendungsdatenbank, z. B. Timeout der Datenbank

Mit dem folgenden Beispiel wird eine Liste von Datenbanken und Eigenschaften zurückgegeben, sodass Sie die Datenbank-GUID (ID) bestimmen können, die Sie anschließend zum Festlegen des Befehls angeben. Eine vollständige Liste der Eigenschaften erhalten Sie anhand von Get-SPRSDatabase | format-list.

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

Unten ist ein Beispiel für die Ausgabe angegeben. Bestimmen Sie die ID für die zu ändernde Datenbank und verwenden Sie die ID im 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  

Um zu überprüfen, ob der Wert festgelegt ist, führen Sie das GET-Cmdlet erneut aus.

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

Auflisten von Reporting Services-Datenerweiterungen – SharePoint-Modus

Das folgende Beispiel durchläuft alle Reporting Services-Dienstanwendungen und listet aktuelle Datenerweiterungen für diese auf.

$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  
}  

Beispielausgabe:

• Name ExtensionType

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

  SQL Data

  SQLAZURE Data

  SQLPDW Data

  OLEDB Data

  OLEDB-MD Data

  ORACLE Data

  ODBC Data

  XML Data

  SHAREPOINTLIST Data

Ändern und Aufführen von Abonnementbesitzern

Weitere Informationen finden Sie unter Verwenden von PowerShell zum Ändern und Auflisten Reporting Services Abonnementbesitzern und Ausführen eines Abonnements.

Weitere Informationen

Verwenden von PowerShell, um Reporting Services-Abonnenten zu ändern und aufzulisten sowie ein Abonnement auszuführen
Prüfliste: Überprüfen von PowerPivot für SharePoint mithilfe von PowerShell
CodePlex-SharePoint-Verwaltungs-PowerShell-Skripts