PowerShell-parancsmagok a Reporting Services SharePoint-módjához

A következőkre vonatkozik: SQL Server Reporting Services (2016) A SharePoint Power BI jelentéskészítő kiszolgálót

Az SQL Server Reporting Services (SSRS) korábbi verzióival kapcsolatos tartalmakért lásd : Mi az AZ SQL Server Reporting Services?

Az SQL Server 2016 Reporting Services SharePoint mód telepítésekor a PowerShell-parancsmagok a jelentéskészítő kiszolgálók SharePoint-módban való támogatásához lesznek telepítve. A parancsmagok három funkciókategóriát fednek le.

A Reporting Services SharePoint megosztott szolgáltatásának és proxyjának telepítése.
A Reporting Services szolgáltatásalkalmazásainak és a kapcsolódó proxyknak a kiépítése és kezelése.
A Reporting Services funkcióinak kezelése, például bővítmények és titkosítási kulcsok.

Megjegyzés:

A Reporting Services SharePoint-integrációja az SQL Server 2016 után már nem érhető el.

Cmdlet összegzése

A parancsmagok futtatásához meg kell nyitnia a SharePoint Management Shellt. Használhatja a Microsoft Windows, a Windows PowerShell integrated Scripting Environment (ISE) részét képező grafikus felhasználói felület szerkesztőt is. További információ: Windows PowerShell indítása Windows Serveren. A következő parancsmag-összefoglalókban a szolgáltatásalkalmazásra (adatbázisok) mutató hivatkozások a Reporting Services szolgáltatásalkalmazás által létrehozott és használt összes adatbázisra vonatkoznak. Ez magában foglalja a konfigurációs, riasztási és ideiglenes adatbázisokat.

Ha a PowerShell-példák megadásakor az alábbihoz hasonló hibaüzenet jelenik meg:

Install-SPRSService: Az "Install-SPRSService" kifejezés nincs felismerve mint
parancsmag, függvény, szkriptfájl vagy operatív program neve. Ellenőrizze a név helyesírását, vagy ha tartalmazott egy elérési utat, ellenőrizze, hogy helyes-e az elérési út, és próbálkozzon újra.

Az alábbi problémák egyike jelentkezik:

A Reporting Services SharePoint mód nincs telepítve, ezért a Reporting Services-parancsmagok nincsenek telepítve.
A PowerShell-parancsot a Windows PowerShellben vagy a Windows PowerShell ISE-ben futtatta a SharePoint Management Shell helyett. Használja a SharePoint Management felületét, vagy adja hozzá a SharePoint beépülő modult a Windows PowerShell ablakához a következő paranccsal:
```
Add-PSSnapin Microsoft.SharePoint.PowerShell  
```

Nyissa meg a SharePoint Management Shellt, és futtassa a parancsmagokat

Válassza a Start gombot.
Válassza ki a Microsoft SharePoint Termékek csoportját.
Válassza ki a SharePoint Management Shellt.

A parancsmag parancssori súgójának megtekintéséhez használja a PowerShell "Get-Help" parancsát a PowerShell parancssorában. Például:

Get-Help Get-SPRSServiceApplicationServers

Megosztott szolgáltatás- és proxyparancsmagok

Az alábbi táblázat a Reporting Services SharePoint megosztott szolgáltatáshoz tartozó PowerShell-parancsmagokat tartalmazza.

Cmdlet (parancsmag)	Description
Install-SPRSService	Telepíti és regisztrálja vagy eltávolítja a Reporting Services megosztott szolgáltatást. Ez a művelet csak azon a gépen hajtható végre, amelyen telepítve van az SQL Server Reporting Services SharePoint módban. A telepítéshez két művelet történik: A Reporting Services szolgáltatás telepítve lett a farmon. -A Reporting Services szolgáltatás példánya telepítve van a jelenlegi gépre. Eltávolítás esetén két művelet történik: -A Reporting Services szolgáltatás el lesz távolítva az aktuális gépről. -A Reporting Services szolgáltatás el lesz távolítva a farmból. Figyelmeztető üzenet jelenik meg, ha a farmban vannak olyan gépek, amelyeken telepítve van a Reporting Services szolgáltatás, vagy ha még mindig futnak Reporting Services-szolgáltatásalkalmazások a farmban.
Install-SPRSServiceProxy	Telepíti és regisztrálja vagy eltávolítja a Reporting Services szolgáltatásproxyt a SharePoint-farmban.
Get-SPRSProxyUrl	Lekéri a Reporting Services szolgáltatás eléréséhez szükséges URL-cím(ek)et.
Get-SPRSServiceApplicationServers	Lekéri a helyi SharePoint-farm összes kiszolgálóját, amely tartalmazza a Reporting Services megosztott szolgáltatás telepítését. Ez a parancsmag hasznos a Reporting Services frissítéséhez, hogy meghatározza, mely kiszolgálók futtatják a megosztott szolgáltatást, ezért frissíteni kell.

Szolgáltatásalkalmazások és proxyparancsmagok

Az alábbi táblázat a Reporting Services szolgáltatásalkalmazásokhoz és a hozzájuk tartozó proxykhoz tartozó PowerShell-parancsmagokat tartalmazza.

cmdlet	Description
Get-SPRSServiceApplication	Lekéri egy vagy több Reporting Services szolgáltatásalkalmazás-objektumot.
New-SPRSServiceApplication	Hozzon létre egy új Reporting Services szolgáltatásalkalmazást és a társított adatbázisokat. LogonType paraméter: Megadja, hogy a jelentéskészítő kiszolgáló az SSRS-alkalmazáskészlet-fiókot vagy egy SQL Server-bejelentkezést használ-e a jelentéskészítő kiszolgáló adatbázisának eléréséhez. Az érvényes értékek a következők: 0 Windows-hitelesítés 1 SQL Server 2 Alkalmazáskészlet-fiók (alapértelmezett)
Remove-SPRSServiceApplication	Eltávolítja a megadott Reporting Services szolgáltatásalkalmazást. Ez a parancsmag a társított adatbázisokat is eltávolítja.
Set-SPRSServiceApplication	Egy meglévő Reporting Services-szolgáltatásalkalmazás tulajdonságait szerkessze.
New-SPRSServiceApplicationProxy	Létrehoz egy új Reporting Services szolgáltatásalkalmazás-proxyt.
Get-SPRSServiceApplicationProxy	Lekér egy vagy több Reporting Services szolgáltatási alkalmazás proxyját.
Dismount-SPRSDatabase	Leválasztja a Szolgáltatásalkalmazás adatbázisait egy Reporting Services-szolgáltatásalkalmazáshoz.
Remove-SPRSDatabase	Távolítsa el a Reporting Services szolgáltatásalkalmazás adatbázisait.
Set-SPRSDatabase	Beállítja a Reporting Services szolgáltatásalkalmazáshoz társított adatbázisok tulajdonságait.
Mount-SPRSDatabase	Adatbázisokat csatlakoztat egy Reporting Services-szolgáltatásalkalmazáshoz.
New-SPRSDatabase	Hozzon létre új szolgáltatásalkalmazás-adatbázisokat a megadott Reporting Services szolgáltatásalkalmazáshoz.
Get-SPRSDatabaseCreationScript	Az adatbázis-létrehozási szkriptet egy Reporting Services-szolgáltatásalkalmazás képernyőjén adja ki. Ezután futtathatja a szkriptet az SQL Server Management Studióban.
Get-SPRSDatabase	Lekér egy vagy több Reporting Services szolgáltatásalkalmazás-adatbázist. A parancs használatával lekérheti a szolgáltatásalkalmazás-adatbázis azonosítóját, így a Set-SPRSDatabase parancsmaggal módosíthatja a tulajdonságokat, például a `querytimeout`. Tekintse meg a jelentéskészítési szolgáltatás alkalmazásadatbázis tulajdonságainak lekérése és beállítása című cikkben szereplő példát.
Get-SPRSDatabaseRightsScript	Egy Reporting Services-szolgáltatásalkalmazás képernyőjére küldi az adatbázis-jogosultsági szkriptet. Kéri a kívánt felhasználót és adatbázist, majd visszaadja az engedélyek módosításához futtatható, tranzakciós SQL-t. Ezután futtathatja ezt a szkriptet az SQL Server Management Studióban.
Get-SPRSDatabaseUpgradeScript	Egy adatbázis-frissítési szkriptet ad ki a képernyőn. A szkript frissíti a Reporting Services szolgáltatásalkalmazás-adatbázisait az aktuális Reporting Services-telepítés adatbázis-verziójára.

A Reporting Services egyéni funkcióparancsmagjai

Cmdlet (parancsmag)	Description
Update-SPRSEncryptionKey	Frissíti a megadott Reporting Services szolgáltatásalkalmazás titkosítási kulcsát, és újra titkosítja az adatait.
Restore-SPRSEncryptionKey	Visszaállít egy korábban biztonsági másolatot készített titkosítási kulcsot egy Reporting Services-szolgáltatásalkalmazáshoz.
Remove-SPRSEncryptedData	Törölje a megadott Reporting Services szolgáltatásalkalmazás titkosított adatait.
Backup-SPRSEncryptionKey	Biztonsági másolatot készít a megadott Reporting Services szolgáltatásalkalmazás titkosítási kulcsáról.
New-SPRSExtension	Regisztrál egy új bővítményt egy Reporting Services-szolgáltatásalkalmazással.
Set-SPRSExtension	Egy meglévő Reporting Services-bővítmény tulajdonságait állítja be.
Remove-SPRSExtension	Eltávolít egy bővítményt egy Reporting Services-szolgáltatásalkalmazásból.
Get-SPRSExtension	Lekéri egy vagy több Reporting Services-bővítményt egy Reporting Services-szolgáltatásalkalmazáshoz. Az érvényes értékek a következők: Kézbesítés KézbesítésUI Render Adat Biztonság Authentication Eseményfeldolgozás JelentésElemek Tervező Jelentéselem-tervező Jelentéselem Átalakító JelentésDefinícióTestreszabás
Get-SPRSSite	Lekéri a SharePoint-webhelyeket attól függően, hogy a "ReportingService" funkció engedélyezve van-e. Alapértelmezés szerint a "ReportingService" szolgáltatást engedélyező webhelyek lesznek visszaadva.

Alapszintű minták

Adja vissza azoknak a parancsmagoknak a listáját, amelyek a névben "SPRS"-t tartalmaznak. Ez a lista a Reporting Services-parancsmagok teljes listája.

Get-command -noun *SPRS*

Vagy egy kicsit részletesebben, egy commandlist.txtnevű szövegfájlba csövezve.

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

Telepítse a Reporting Services SharePoint szolgáltatás- és szolgáltatásproxyt.

Install-SPRSService

Install-SPRSServiceProxy

Indítsa el a Reporting Services szolgáltatást.

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

A SharePoint Management Shellben adja meg a következő parancsot a naplófájlból származó sorok szűrt listájának visszaadásához. A parancs az "ssrscustomactionerror" szöveget tartalmazó sorokra szűr. Ez a példa a rssharepoint.msi telepítésekor létrehozott naplófájlt szemlélteti.

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

Részletes minták

A következő minták mellett tekintse meg az 1–4. lépéshez készült Windows PowerShell-szkript című cikk "Windows PowerShell-szkript" című szakaszát.

Reporting Services-szolgáltatásalkalmazás és -proxy létrehozása

Ez a példaszkript a következő feladatokat hajtja végre:

Hozzon létre egy Reporting Services-szolgáltatásalkalmazást és -proxyt. A szkript feltételezi, hogy a "Saját alkalmazáskészlet" alkalmazáskészlet már létezik.
A proxy hozzáadása az alapértelmezett proxycsoporthoz
Adjon hozzáférést a szolgáltatásalkalmazásnak a 80-s port webalkalmazás tartalomadatbázisához. A szkript feltételezi, hogy a webhely https://sitename már létezik.

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

Reporting Services-kézbesítési bővítmény áttekintése és frissítése

Az alábbi PowerShell-példaszkript frissíti a jelentéskészítő kiszolgáló e-mail-kézbesítési bővítményének konfigurációját a nevesített My RS Service Appszolgáltatásalkalmazáshoz. Frissítse az SMTP-kiszolgáló (<email server name>) és a FROM e-mail alias (<your FROM email address>) értékeit.

$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

A fenti példában, ha nem tudta a szolgáltatásalkalmazás pontos nevét, átírhatja az első utasítást, hogy a részleges név keresése alapján kérje le a szolgáltatásalkalmazást. Például:

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

A következő szkript a jelentéskészítő kiszolgáló e-mail-kézbesítési bővítményének aktuális konfigurációs értékeit adja vissza a "Reporting Services-alkalmazás" nevű szolgáltatásalkalmazáshoz. Az első lépés a $app változó értékét annak a szolgáltatásalkalmazásnak az objektumára állítja, amelynek neve " Saját RS Service App"

A második utasítás lekéri a szolgáltatásalkalmazás objektumához tartozó "Jelentéskészítő Kiszolgáló E-mail" kézbesítési bővítményt a $app változóban, majd kiválasztja a configurationXML-t.

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

Az előző két utasítást is átírhatja egyként:

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

A Reporting Service-alkalmazás adatbázisának tulajdonságainak lekérése és beállítása

Az alábbi példa először az adatbázisok és tulajdonságok listáját adja vissza, így meghatározhatja az adatbázis guid azonosítóját (azonosítóját), amelyet aztán a beállított parancsnak ad meg. A tulajdonságok teljes listájához használja a következőt: Get-SPRSDatabase | format-list.

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

Az alábbi kimenet egy példa. Határozza meg a módosítani kívánt adatbázis azonosítóját, és használja az azonosítót a SET parancsmagban.

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

Az érték beállításának ellenőrzéséhez futtassa újra a GET parancsmagot.

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

Reporting Services-adatbővítmények listázása

Az alábbi példa végigfut az egyes Reporting Services-szolgáltatásalkalmazásokon, és felsorolja az egyes alkalmazások aktuális adatkiterjesztéseit.

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

Példakimenet:

Name ExtensionType

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

SQL Data

SQLAZURE Data

SQLPDW Data

OLEDB Data

OLEDB-MD Data

ORACLE Data

ODBC Data

XML Data

SHAREPOINTLIST Data

Reporting Services-előfizetések tulajdonosainak módosítása és listázása

Lásd: A Reporting Services-előfizetések tulajdonosainak módosítása és listázása és előfizetés futtatása a PowerShell használatával.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-08-25