PowerShell-cmdlets voor de SharePoint-modus van Reporting Services

Van toepassing op: SQL Server Reporting Services (2016) SharePoint ❌ Power BI Report Server

Voor inhoud met betrekking tot eerdere versies van SQL Server Reporting Services (SSRS) raadpleegt u Wat is SQL Server Reporting Services?

Wanneer u SQL Server 2016 Reporting Services SharePoint-modus installeert, worden PowerShell-cmdlets geïnstalleerd ter ondersteuning van rapportservers in de SharePoint-modus. De cmdlets hebben betrekking op drie categorieën functionaliteit.

• Installatie van de gedeelde Reporting Services SharePoint-service en proxy.

• Inrichten en beheren van Reporting Services-servicetoepassingen en bijbehorende proxy's.

• Beheer van Reporting Services-functies, bijvoorbeeld extensies en versleutelingssleutels.

Cmdlet-samenvatting

Als u de cmdlets wilt uitvoeren, moet u de SharePoint-beheershell openen. U kunt ook de grafische gebruikersinterface-editor gebruiken die is opgenomen in Microsoft Windows, Windows PowerShell Integrated Scripting Environment (ISE). Zie Windows PowerShell starten op Windows Server voor meer informatie. In de volgende cmdlet-samenvattingen verwijzen de verwijzingen naar de databases van de servicetoepassing naar alle databases die zijn gemaakt en gebruikt door een Reporting Services-servicetoepassing. Dit omvat de configuratie-, waarschuwings- en tijdelijke databases.

Als u een foutbericht ziet dat lijkt op het volgende wanneer u de PowerShell-voorbeelden invoert:

• Install-SPRSService: de term 'Install-SPRSService' wordt niet herkend als de
  naam van een cmdlet, functie, scriptbestand of bruikbaar programma. Controleer de spelling van de naam of controleer of een pad is opgenomen, controleer of het pad juist is en probeer het opnieuw.

Een van de volgende problemen treedt op:

• De SharePoint-modus van Reporting Services is niet geïnstalleerd en daarom worden de Reporting Services-cmdlets niet geïnstalleerd.

• U hebt de PowerShell-opdracht uitgevoerd in Windows PowerShell of Windows PowerShell ISE in plaats van de SharePoint-beheershell. Gebruik de SharePoint-beheershell of voeg de SharePoint-module toe aan het Windows PowerShell-venster met de volgende opdracht:

  Add-PSSnapin Microsoft.SharePoint.PowerShell  
  

Open de SharePoint-beheershell en voer cmdlets uit

1. Klik op de Start-knop.

2. Selecteer de groep Microsoft SharePoint-producten .

3. Selecteer de SharePoint-beheershell.

Om de opdrachtregelhelp voor een cmdlet te bekijken, gebruikt u de PowerShell-opdracht 'Get-Help' in de PowerShell-opdrachtprompt. Voorbeeld:

Get-Help Get-SPRSServiceApplicationServers

Gedeelde service- en proxy-cmdlets

De volgende tabel bevat de PowerShell-cmdlets voor de gedeelde Reporting Services SharePoint-service.

Serviceapplicatie en proxy-cmdlets

De volgende tabel bevat de PowerShell-cmdlets voor Reporting Services-servicetoepassingen en de bijbehorende proxy's.

Cmdlets voor aangepaste functionaliteit van Reporting Services

Basisvoorbeelden

Retourneert een lijst met cmdlets die SPRS in de naam bevatten. Dit is de volledige lijst van Reporting Services-cmdlets.

Get-command -noun *SPRS*  

Of met een beetje meer details, doorgesluisd naar een tekstbestand met de naam commandlist.txt.

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

Installeer de SharePoint-service en -serviceproxy van Reporting Services.

Install-SPRSService  

Install-SPRSServiceProxy  

Start de Reporting Services service.

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

Voer de volgende opdracht uit de SharePoint Management Shell in om een gefilterde lijst met rijen uit het logboekbestand te retourneren. De opdrachtfilters voor regels die 'ssrscustomactionerror' bevatten. In dit voorbeeld wordt het logboekbestand bekeken dat is gemaakt toen de rssharepoint.msi is geïnstalleerd.

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

Gedetailleerde voorbeelden

Zie naast de volgende voorbeelden de sectie 'Windows PowerShell-script' in het artikel Windows PowerShell-script voor stap 1-4.

Een Reporting Services-servicetoepassing en -proxy maken

Met dit voorbeeldscript worden de volgende taken uitgevoerd:

1. Maak een Reporting Services-servicetoepassing en -proxy. In het script wordt ervan uitgegaan dat de groep van toepassingen 'Mijn app-groep' al bestaat.

2. De proxy toevoegen aan de standaardproxygroep

3. Geef de service-app toegang tot de contentdatabase van de poort 80 web-app. In het script wordt ervan uitgegaan dat de site https://sitename al bestaat.

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

Een Reporting Services-leveringsextensie controleren en bijwerken

In het volgende PowerShell-voorbeeldscript wordt de configuratie voor de e-mailbezorgingsextensie van de rapportserver bijgewerkt voor de servicetoepassing met de naam My RS Service App. Werk de waarden voor de SMTP-server (<email server name>) en de FROM-e-mailalias (<your FROM email address>) bij.

$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  

Als u in het bovenstaande voorbeeld niet de exacte naam van de servicetoepassing wist, kunt u de eerste instructie herschrijven om de servicetoepassing op te halen op basis van een zoekopdracht naar de gedeeltelijke naam. Voorbeeld:

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

Het volgende script retourneert de huidige configuratiewaarden voor de e-mailleveringsextensie van de rapportserver voor de servicetoepassing met de naam Reporting Services-toepassing. In de eerste stap wordt de waarde van de variabele $app ingesteld op het object van de servicetoepassing met de naam 'My RS Service-app'

Met de tweede instructie haalt u de bezorgingsextensie ‘Report Server Email’ op voor het servicetoepassingsobject in variabele $app, en selecteert vervolgens de configurationXML.

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

U kunt de vorige twee instructies ook opnieuw schrijven als één:

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

Eigenschappen van de Reporting Service-toepassingsdatabase ophalen en instellen

In het volgende voorbeeld wordt eerst een lijst met de databases en eigenschappen geretourneerd, zodat u de database-GUID (ID) kunt bepalen die u vervolgens opgeeft aan de setopdracht. Gebruik Get-SPRSDatabase | format-listvoor een volledige lijst met eigenschappen.

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

De volgende uitvoer is een voorbeeld. Bepaal de id voor de database die u wilt wijzigen en gebruik de id in de 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  

Voer de GET-cmdlet opnieuw uit om te controleren of de waarde is ingesteld.

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

Reporting Services-gegevensextensies weergeven

In het volgende voorbeeld wordt elke Reporting Services-servicetoepassing doorlopen en worden de huidige gegevensextensies voor elke toepassing weergegeven.

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

Voorbeelduitvoer:

• Name ExtensionType

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

  SQL Data

  SQLAZURE Data

  SQLPDW Data

  OLEDB Data

  OLEDB-MD Data

  ORACLE Data

  ODBC Data

  XML Data

  SHAREPOINTLIST Data

Eigenaren van Reporting Services-abonnementen wijzigen en vermelden

Zie PowerShell gebruiken om eigenaren van Reporting Services-abonnementen te wijzigen en weer te geven en een abonnement uit te voeren.

Verwante inhoud

• PowerShell gebruiken om eigenaren van Reporting Services-abonnementen te wijzigen en weer te geven en een abonnement uit te voeren
• CheckList: PowerShell gebruiken om Power Pivot voor SharePoint te verifiëren
• Hulp krijgen bij SQL Server PowerShell
• Probeer het eens bij het Reporting Services forum