Mengakses penyedia WMI Reporting Services

Penyedia WMI Reporting Services mengekspos dua kelas WMI untuk administrasi instans server laporan mode asli melalui pembuatan skrip:

Penting

Dimulai dengan rilis SQL Server 2012 (11.x), penyedia WMI didukung hanya untuk server laporan mode asli. Server laporan mode SharePoint dapat dikelola dengan halaman Administrasi Pusat SharePoint dan skrip PowerShell.

Kelas	Ruang nama	Deskripsi
MSReportServer_Instance	root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v13	Menyediakan informasi dasar yang diperlukan klien untuk menyambungkan ke server laporan yang diinstal.
MSReportServer_ConfigurationSetting	root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v13\Admin	Mewakili parameter penginstalan dan run-time instans server laporan. Parameter ini disimpan dalam file konfigurasi untuk server laporan. ** Penting ** Kelas ini hanya dapat diakses dengan hak istimewa administratif.

Instans dari setiap kelas di atas dibuat untuk setiap instans server laporan. Anda dapat menggunakan alat Microsoft atau non-Microsoft apa pun untuk mengakses objek WMI yang diekspos oleh server laporan, termasuk antarmuka pemrograman WMI yang diekspos oleh .NET Framework itu sendiri. Artikel ini menjelaskan cara mengakses dan menggunakan instans kelas WMI dengan perintah PowerShell Get-WmiObject.

Menentukan nama instans dalam string namespace

Nama instans di jalur namespace layanan untuk kelas WMI Reporting Services adalah pengodean nama instans yang Anda tentukan saat menginstal instans Reporting Services bernama. Yaitu, karakter khusus dalam nama instans dikodekan. Misalnya, garis bawah (_) dikodekan sebagai _5f, sehingga nama My_Instance instans dikodekan seperti My_5fInstance di jalur namespace layanan WMI.

Untuk mencantumkan nama instans yang dikodekan dari instans server laporan Anda di jalur namespace layanan WMI, gunakan perintah PowerShell berikut:

PS C:\windows\system32> Get-WmiObject -namespace root\Microsoft\SqlServer\ReportServer  -class __Namespace -ComputerName hostname | select Name  

Mengakses kelas WMI dengan menggunakan PowerShell

Untuk mengakses kelas WMI, jalankan perintah berikut:

PS C:\windows\system32> Get-WmiObject -namespace <namespacename> -class <classname> -ComputerName <hostname>  

Misalnya, untuk mengakses kelas MSReportServer_ConfigurationSetting pada instans server laporan default host myrshost, jalankan perintah berikut. Instans server laporan default harus diinstal di myrshost agar perintah ini berhasil.

PS C:\windows\system32> Get-WmiObject -namespace "root\Microsoft\SqlServer\ReportServer\RS_MSSQLSERER\v11\Admin" -class MSReportServer_ConfigurationSetting -ComputerName myrshost  

Sintaks perintah ini menghasilkan semua nama dan nilai properti kelas. Semua instans kelas MSReportServer_ConfigurationSetting dikembalikan, meskipun Anda mengakses kelas di namespace instans server laporan default (RS_MSSQLSERVER). Misalnya, myrshost mungkin diinstal dengan instans server laporan default dan instans server laporan bernama yang disebut SHAREPOINT. Perintah ini mengembalikan dua objek WMI dan menghasilkan nama dan nilai properti untuk kedua instans server laporan.

Untuk mengembalikan instans kelas tertentu saat beberapa instans dikembalikan, gunakan parameter -Filter untuk memfilter hasil berdasarkan properti dengan nilai unik seperti InstanceName. Misalnya, untuk mengembalikan hanya objek WMI untuk instans server laporan default, gunakan perintah berikut:

PS C:\windows\system32> Get-WmiObject -namespace "root\Microsoft\SqlServer\ReportServer\RS_MSSQLServer\v13\Admin" -class MSReportServer_ConfigurationSetting -ComputerName myrshost -filter "InstanceName='MSSQLSERVER'"  

Mengkueri metode dan properti yang tersedia

Untuk melihat metode dan properti apa yang tersedia di salah satu kelas WMI Reporting Services, pipa hasilnya dari Get-WmiObject ke perintah Get-Member. Misalnya:

PS C:\windows\system32> Get-WmiObject -namespace "root\Microsoft\SqlServer\ReportServer\RS_MSSQLServer\v13\Admin" -class MSReportServer_ConfigurationSetting -ComputerName myrshost | Get-Member  

Menggunakan metode atau properti WMI

Setelah Anda memiliki objek WMI ke kelas Reporting Services dan mengetahui metode dan properti yang tersedia, Anda dapat menggunakan metode dan properti ini. Misalnya, jika Anda memiliki instans server laporan bernama dalam mode terintegrasi SharePoint yang disebut SHAREPOINT, gunakan urutan perintah berikut untuk mengambil URL untuk situs Administrasi Pusat SharePoint:

PS C:\windows\system32> $rsconfig = Get-WmiObject -namespace "root\Microsoft\SqlServer\ReportServer\RS_MSSQLServer\v13\Admin" -class MSReportServer_ConfigurationSetting -ComputerName myrshost -filter "InstanceName='SHAREPOINT'"  
PS C:\windows\system32> $rsconfig.GetAdminSiteUrl()  
  

Konten terkait

Referensi pustaka penyedia WMI Reporting Services (SSRS)
File konfigurasi RsReportServer.config