Cmdlet PowerShell untuk mode SharePoint SQL Server Reporting Services
Berlaku untuk:
Server Laporan Power BI SharePoint ❌ SQL Server Reporting Services (2016)
Untuk konten yang terkait dengan versi SQL Server Reporting Services (SSRS) sebelumnya, lihat SQL Server 2014 Reporting Services.
Saat Anda menginstal mode SharePoint SQL Server 2016 Reporting Services, cmdlet PowerShell diinstal untuk mendukung server laporan dalam mode SharePoint. Cmdlet mencakup tiga kategori fungsionalitas.
Penginstalan layanan dan proksi bersama Reporting Services SharePoint.
Provisi dan manajemen aplikasi layanan Reporting Services dan proksi terkait.
Manajemen fitur Reporting Services, misalnya ekstensi dan kunci enkripsi.
Catatan
Integrasi Reporting Services dengan SharePoint tidak lagi tersedia setelah SQL Server 2016.
Ringkasan cmdlet
Untuk menjalankan cmdlet, Anda perlu membuka SharePoint Management Shell. Anda juga dapat menggunakan editor antarmuka pengguna grafis yang disertakan dengan Microsoft Windows, Windows PowerShell Integrated Scripting Environment (ISE). Untuk informasi selengkapnya, lihat Memulai Windows PowerShell di Windows Server. Dalam ringkasan cmdlet berikut, referensi ke aplikasi layanan "database." lihat semua database yang dibuat dan digunakan oleh aplikasi layanan Reporting Services. Ini termasuk konfigurasi, pemberitahuan, dan database sementara.
Jika Anda melihat pesan kesalahan yang mirip dengan yang berikut ini saat Anda memasukkan contoh PowerShell:
- Install-SPRSService: Istilah 'Install-SPRSService' tidak dikenali sebagai
nama cmdlet, fungsi, file skrip, atau program yang dapat dioperasikan. Periksa ejaan nama, atau jika jalur disertakan, verifikasi bahwa jalur tersebut benar dan coba lagi.
Salah satu masalah berikut ini terjadi:
Mode SharePoint Reporting Services tidak diinstal dan oleh karena itu cmdlet Reporting Services tidak diinstal.
Anda menjalankan perintah PowerShell di Windows PowerShell atau Windows PowerShell ISE alih-alih SharePoint Management Shell. Gunakan shell Manajemen SharePoint atau tambahkan SharePoint Snap-in ke jendela Windows PowerShell dengan perintah berikut:
Add-PSSnapin Microsoft.SharePoint.PowerShell
Untuk informasi selengkapnya, lihat Menggunakan Windows PowerShell untuk mengelola SharePoint 2013.
Buka SharePoint Management Shell dan jalankan cmdlet
Pilih tombol Mulai .
Pilih grup Produk Microsoft SharePoint.
Pilih SharePoint Management Shell.
Untuk melihat bantuan baris perintah untuk cmdlet, gunakan perintah PowerShell 'Get-Help' di prompt perintah PowerShell. Contohnya:
Get-Help Get-SPRSServiceApplicationServers
Layanan bersama dan cmdlet proksi
Tabel berikut ini berisi cmdlet PowerShell untuk layanan bersama SharePoint Reporting Services.
| Cmdlet | Deskripsi |
|---|---|
| Install-SPRSService | Menginstal dan mendaftarkan, atau menghapus instalan, layanan bersama Reporting Services. Tindakan ini hanya dapat dilakukan pada komputer yang memiliki penginstalan SQL Server Reporting Services dalam mode SharePoint. Untuk penginstalan, dua operasi terjadi: -Layanan Pelaporan diinstal di farm. -Instans layanan Reporting Services diinstal ke komputer saat ini. Untuk Penghapusan instalasi, dua operasi terjadi: -Layanan Pelaporan dihapus instalannya dari komputer saat ini. -Layanan Pelaporan dihapus instalannya dari farm. Pesan peringatan muncul jika ada komputer lain di farm yang menginstal layanan Reporting Services, atau jika masih ada aplikasi layanan Reporting Services yang berjalan di farm. |
| Install-SPRSServiceProxy | Menginstal dan mendaftarkan, atau menghapus instalasi, proksi layanan Reporting Services di farm SharePoint. |
| Get-SPRSProxyUrl | Mendapatkan URL untuk mengakses layanan Reporting Services. |
| Get-SPRSServiceApplicationServers | Mendapatkan semua server di farm SharePoint lokal yang berisi penginstalan layanan bersama Reporting Services. Cmdlet ini berguna untuk peningkatan Reporting Services, untuk menentukan server mana yang menjalankan layanan bersama dan oleh karena itu perlu ditingkatkan. |
Aplikasi layanan dan cmdlet proksi
Tabel berikut berisi cmdlet PowerShell untuk aplikasi layanan Reporting Services dan proksi terkait.
| cmdlet | Deskripsi |
|---|---|
| Get-SPRSServiceApplication | Mendapatkan satu atau beberapa objek aplikasi layanan Reporting Services. |
| New-SPRSServiceApplication | Buat aplikasi layanan Reporting Services baru dan database terkait. Parameter LogonType: Menentukan apakah server laporan menggunakan akun Kumpulan Aplikasi SSRS atau masuk SQL Server untuk mengakses database server laporan. Nilai yang valid adalah: 0 Autentikasi Windows 1 SQL Server 2 Akun Kumpulan Aplikasi (default) |
| Remove-SPRSServiceApplication | Menghapus aplikasi layanan Reporting Services yang ditentukan. Cmdlet ini juga menghapus database terkait. |
| Set-SPRSServiceApplication | Mengedit properti aplikasi layanan Reporting Services yang ada. |
| New-SPRSServiceApplicationProxy | Membuat proksi aplikasi layanan Reporting Services baru. |
| Get-SPRSServiceApplicationProxy | Mendapatkan satu atau beberapa proksi aplikasi layanan Reporting Services. |
| Dismount-SPRSDatabase | Melepas database aplikasi layanan untuk aplikasi layanan Reporting Services. |
| Remove-SPRSDatabase | Hapus database aplikasi layanan untuk aplikasi layanan Reporting Services. |
| Set-SPRSDatabase | Mengatur properti database yang terkait dengan aplikasi layanan Reporting Services. |
| Mount-SPRSDatabase | Memasang database untuk aplikasi layanan Reporting Services. |
| New-SPRSDatabase | Buat database aplikasi layanan baru untuk aplikasi layanan Reporting Services yang ditentukan. |
| Get-SPRSDatabaseCreationScript | Menghasilkan skrip pembuatan database ke layar untuk aplikasi layanan Reporting Services. Anda kemudian dapat menjalankan skrip di SQL Server Management Studio. |
| Get-SPRSDatabase | Mendapatkan satu atau beberapa database aplikasi layanan Reporting Services. Gunakan perintah untuk mendapatkan ID database aplikasi layanan sehingga Anda dapat menggunakan cmdlet Set-SPRSDatabase untuk memodifikasi properti, misalnya querytimeout. Lihat contoh dalam artikel ini, Dapatkan dan atur Properti database aplikasi Reporting Service. |
| Get-SPRSDatabaseRightsScript | Menghasilkan skrip hak database ke layar untuk aplikasi layanan Reporting Services. Ini meminta pengguna dan database yang diinginkan kemudian mengembalikan SQL bertransaksi yang dapat Anda jalankan untuk mengubah izin. Anda kemudian dapat menjalankan skrip ini di SQL Server Management Studio. |
| Get-SPRSDatabaseUpgradeScript | Menghasilkan skrip peningkatan database ke layar. Skrip meningkatkan database aplikasi layanan Reporting Services ke versi database penginstalan Reporting Services saat ini. |
Cmdlet fungsionalitas kustom Reporting Services
| Cmdlet | Deskripsi |
|---|---|
| Update-SPRSEncryptionKey | Memperbarui kunci enkripsi untuk aplikasi layanan Reporting Services yang ditentukan dan mengenkripsi ulang datanya. |
| Restore-SPRSEncryptionKey | Memulihkan kunci enkripsi yang dicadangkan sebelumnya untuk aplikasi layanan Reporting Services. |
| Remove-SPRSEncryptedData | Hapus data terenkripsi untuk aplikasi layanan Reporting Services yang ditentukan. |
| Backup-SPRSEncryptionKey | Mencadangkan kunci enkripsi untuk aplikasi layanan Reporting Services yang ditentukan. |
| New-SPRSExtension | Mendaftarkan ekstensi baru dengan aplikasi layanan Reporting Services. |
| Set-SPRSExtension | Mengatur properti ekstensi Reporting Services yang ada. |
| Remove-SPRSExtension | Menghapus ekstensi dari aplikasi layanan Reporting Services. |
| Get-SPRSExtension | Mendapatkan satu atau beberapa ekstensi Reporting Services untuk aplikasi layanan Reporting Services. Nilai yang valid adalah: Pengiriman DeliveryUI Render Data Keamanan Autentikasi EventProcessing ReportItems Perancang ReportItemDesigner ReportItemConverter ReportDefinitionCustomization |
| Get-SPRSSite | Mendapatkan situs SharePoint berdasarkan apakah fitur "ReportingService" diaktifkan. Secara default, situs yang mengaktifkan fitur "ReportingService" dikembalikan. |
Sampel dasar
Mengembalikan daftar cmdlet yang berisi 'SPRS' dalam nama. Daftar ini adalah daftar lengkap cmdlet Reporting Services.
Get-command -noun *SPRS*
Atau dengan sedikit detail lebih lanjut, disalurkan ke file teks bernama commandlist.txt.
Get-command -noun *SPRS* | Select name, definition | Format-List | Out-File c:\commandlist.txt
Instal layanan SharePoint Reporting Services dan proksi layanan.
Install-SPRSService
Install-SPRSServiceProxy
Mulai layanan Reporting Services.
get-spserviceinstance -all |where {$_.TypeName -like "SQL Server Reporting*"} | Start-SPServiceInstance
Masukkan perintah berikut dari SharePoint Management Shell untuk mengembalikan daftar baris yang difilter dari file log. Perintah memfilter baris yang berisi "ssrscustomactionerror". Contoh ini melihat file log yang dibuat ketika rssharepoint.msi diinstal.
Get-content -path C:\Users\testuser\AppData\Local\Temp\rs_sp_0.log | select-string "ssrscustomactionerror"
Sampel terperinci
Selain sampel berikut, lihat bagian "Skrip Windows PowerShell" dalam artikel skrip Windows PowerShell untuk Langkah 1-4.
Membuat aplikasi dan proksi layanan Reporting Services
Contoh skrip ini menyelesaikan tugas berikut:
Buat aplikasi dan proksi layanan Reporting Services. Skrip mengasumsikan kumpulan aplikasi "Kumpulan Aplikasi Saya" sudah ada.
Menambahkan proksi ke grup proksi default
Berikan akses aplikasi layanan ke database konten aplikasi web port 80. Skrip mengasumsikan situs
https://sitenamesudah ada.
# 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)
Meninjau dan memperbarui ekstensi pengiriman Reporting Services
Contoh skrip PowerShell berikut memperbarui konfigurasi untuk ekstensi pengiriman email server laporan untuk aplikasi layanan bernama My RS Service App. Perbarui nilai untuk server SMTP (<email server name>) dan alias email 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
Dalam contoh di atas, jika Anda tidak tahu nama yang tepat dari aplikasi layanan, Anda dapat menulis ulang pernyataan pertama untuk mendapatkan aplikasi layanan berdasarkan pencarian nama parsial. Contohnya:
$app=get-sprsserviceapplication | where {$_.name -like " ssrs_testapp *"}
Skrip berikut mengembalikan nilai konfigurasi saat ini untuk ekstensi pengiriman email server laporan untuk aplikasi layanan bernama "Aplikasi Reporting Services." Langkah pertama menetapkan nilai variabel $app ke objek aplikasi layanan yang memiliki nama " Aplikasi Layanan RS Saya "
Pernyataan kedua akan Mendapatkan ekstensi pengiriman 'Email Server Laporan' untuk objek aplikasi layanan dalam variabel $app, dan pilih configurationXML.
$app=get-sprsserviceapplication -Name "Reporting Services Application"
Get-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml
Anda juga dapat menulis ulang dua pernyataan sebelumnya sebagai satu:
get-sprsserviceapplication -Name "Reporting Services Application" | Get-SPRSExtension -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml
Mendapatkan dan mengatur properti database aplikasi Reporting Service
Contoh berikut pertama-tama mengembalikan daftar database dan properti sehingga Anda dapat menentukan panduan database (ID) yang kemudian Anda berikan ke perintah set. Untuk daftar lengkap properti, gunakan Get-SPRSDatabase | format-list.
get-SPRSDatabase | select id, querytimeout,connectiontimeout, status, server, ServiceInstance
Output berikut adalah contoh. Tentukan ID untuk database yang ingin Anda ubah dan gunakan ID di cmdlet SET.
Id : 56f8d1bc-cb04-44cf-bd41-a873643c5a14QueryTimeout : 120ConnectionTimeout : 15Status : OnlineServer : SPServer Name=uetestb01ServiceInstance : SPDatabaseServiceInstance
Set-SPRSDatabase -identity 56f8d1bc-cb04-44cf-bd41-a873643c5a14 -QueryTimeout 300
Untuk memverifikasi nilai diatur, jalankan cmdlet GET lagi.
Get-SPRSDatabase -identity 56f8d1bc-cb04-44cf-bd41-a873643c5a14 | select id, querytimeout,connectiontimeout, status, server, ServiceInstance
Mencantumkan ekstensi data Reporting Services
Contoh berikut mengulang melalui setiap aplikasi layanan Reporting Services dan mencantumkan ekstensi data saat ini untuk masing-masing.
$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
}
Contoh output:
Name ExtensionType---- -------------SQL DataSQLAZURE DataSQLPDW DataOLEDB DataOLEDB-MD DataORACLE DataODBC DataXML DataSHAREPOINTLIST Data
Mengubah dan mencantumkan pemilik langganan Reporting Services
Konten terkait
Menggunakan PowerShell untuk mengubah dan mencantumkan pemilik langganan Reporting Services dan menjalankan langganan
CheckList: Gunakan PowerShell untuk memverifikasi Power Pivot untuk SharePoint
Mendapatkan bantuan SQL Server PowerShell
Ada pertanyaan lagi? Coba tanyakan forum Reporting Services
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk