utilitas RS.exe (SSRS)
Utilitas rs.exe memproses skrip yang Anda berikan dalam file input. Gunakan utilitas ini untuk mengotomatiskan tugas penyebaran dan administrasi server laporan.
Catatan
Dimulai dengan SQL Server 2008 R2 (10.50.x), utilitas rs didukung terhadap server laporan yang dikonfigurasi untuk mode terintegrasi SharePoint serta server yang dikonfigurasi dalam mode asli. Versi sebelumnya hanya mendukung konfigurasi mode asli.
Sintaks
rs {-?}
{-i input_file}
{-s serverURL}
{-u username}
{-p password}
{-e endpoint}
{-l time_out}
{-b batchmode}
{-v globalvars=}
{-t trace}
Lokasi file
RS.exe terletak di folder berikut, tergantung pada versi server laporan. Anda dapat menjalankan utilitas dari folder apa pun di sistem file Anda.
Berlaku untuk: 
SQL Server Reporting Services (2016)
C:\Program Files (x86)\Microsoft SQL Server\130\Tools\Binn
Berlaku untuk: SQL Server Reporting Services (2017 dan yang lebih baru)
C:\Program Files\Microsoft SQL Server Reporting Services\Shared Tools
Berlaku untuk: Server Laporan Power BI
C:\Program Files\Microsoft Power BI Report Server\Shared Tools
Argumen
-?
(Opsional) Menampilkan sintaks argumen rs .
-i input_file
(Diperlukan) Menentukan file .rss yang akan dijalankan. Nilai ini dapat menjadi jalur relatif atau sepenuhnya memenuhi syarat ke file .rss.
-s serverURL
(Diperlukan) Menentukan nama server Web dan nama direktori virtual server laporan untuk menjalankan file. Contoh URL server laporan adalah https://examplewebserver/reportserver. Awalan http:// atau https:// di awal nama server bersifat opsional. Jika Anda menghilangkan awalan, host skrip server laporan mencoba menggunakan https terlebih dahulu, lalu menggunakan http jika https tidak berfungsi.
-u [domain\]nama pengguna
(Opsional) Menentukan akun pengguna yang digunakan untuk menyambungkan ke server laporan. Jika -u dan -p dihilangkan, akun pengguna Windows saat ini digunakan.
-p password
(Diperlukan jika -u ditentukan) Menentukan kata sandi yang akan digunakan dengan argumen -u . Nilai ini peka huruf besar/kecil.
-e
(Opsional) Menentukan titik akhir SOAP tempat skrip harus dijalankan. Nilai yang valid adalah:
Mgmt2010
Mgmt2006
Mgmt2005
Exec2005
Jika nilai tidak ditentukan, titik akhir Mgmt2005 digunakan. Untuk informasi selengkapnya tentang titik akhir SOAP, lihat Melaporkan titik akhir layanan web server.
- Aku time_out
(Opsional) Menentukan jumlah detik yang berlalu sebelum koneksi ke server kehabisan waktu. Defaultnya adalah 60 detik. Jika Anda tidak menentukan nilai waktu habis, default akan digunakan. Nilai 0 menentukan bahwa koneksi tidak pernah kehabisan waktu.
-b
(Opsional) Menentukan bahwa perintah dalam file skrip berjalan dalam batch. Jika ada perintah yang gagal, batch akan digulung balik. Beberapa perintah tidak dapat di-batch, dan perintah tersebut berjalan seperti biasa. Hanya pengecualian yang dilemparkan dan tidak ditangani dalam skrip yang mengakibatkan pembatalan. Jika skrip menangani pengecualian dan kembali secara normal dari Utama, batch diterapkan. Jika Anda menghilangkan parameter ini, perintah berjalan tanpa membuat batch. Untuk informasi selengkapnya, lihat Metode batching.
-v globalvar
(Opsional) Menentukan variabel global yang digunakan dalam skrip. Jika skrip menggunakan variabel global, Anda harus menentukan argumen ini. Nilai yang Anda tentukan harus valid untuk variabel global yang ditentukan dalam file .rss. Anda harus menentukan satu variabel global untuk setiap argumen -v .
Argumen -v ditentukan pada baris perintah dan digunakan untuk mengatur nilai untuk variabel global yang ditentukan dalam skrip Anda pada waktu proses. Misalnya, jika skrip Anda berisi variabel bernama parentFolder, Anda dapat menentukan nama untuk folder tersebut pada baris perintah:
rs.exe -i myScriptFile.rss -s https://myServer/reportserver -v parentFolder="Financial Reports"
Variabel global dibuat dengan nama yang diberikan dan diatur ke nilai yang disediakan. Misalnya, -v a="1" -v b="2" menghasilkan variabel bernama dengan nilai"1" dan variabel b dengan nilai "2".
Variabel global tersedia untuk fungsi apa pun dalam skrip. Garis miring terbalik dan tanda kutip (\") ditafsirkan sebagai tanda kutip ganda. Tanda kutip diperlukan hanya jika string berisi spasi. Nama variabel harus valid untuk Microsoft Visual Basic. Mereka harus dimulai dengan karakter alfabet atau garis bawah dan berisi karakter alfabet, digit, atau garis bawah. Kata yang dipesan tidak dapat digunakan sebagai nama variabel. Untuk informasi selengkapnya tentang menggunakan variabel global, lihat Koleksi bawaan dalam ekspresi (Report Builder dan SSRS).
-t
(Opsional) Menghasilkan pesan kesalahan ke log pelacakan. Argumen ini tidak mengambil nilai. Untuk informasi selengkapnya, lihat Melaporkan log pelacakan layanan server.
Izin
Untuk menjalankan alat, Anda harus memiliki izin untuk menyambungkan ke instans server laporan tempat Anda menjalankan skrip. Anda dapat menjalankan skrip untuk membuat perubahan pada komputer lokal atau komputer jarak jauh. Untuk membuat perubahan pada server laporan yang diinstal pada komputer jarak jauh, tentukan komputer jarak jauh dalam argumen -s .
Contoh
Contoh berikut mengilustrasikan cara menentukan file skrip yang berisi skrip Visual Basic .NET dan metode layanan Web yang ingin Anda jalankan.
rs -i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver
Untuk contoh terperinci, lihat Contoh skrip rs.exe Reporting Services untuk menyalin konten antar server laporan.
Untuk contoh selengkapnya, lihat Menjalankan file skrip Reporting Services
Keterangan
Anda dapat menentukan skrip untuk mengatur properti sistem, menerbitkan laporan, dan sebagainya. Skrip yang Anda buat dapat menyertakan metode APA pun dari API Reporting Services. Untuk informasi selengkapnya tentang metode dan properti yang tersedia untuk Anda, lihat Melaporkan layanan web server.
Skrip harus ditulis dalam kode Visual Basic .NET, dan disimpan dalam file teks Unicode atau UTF-8 dengan ekstensi nama file .rss. Anda tidak dapat men-debug skrip dengan utilitas rs . Untuk men-debug skrip, jalankan kode dalam Microsoft Visual Studio.
Tip
Untuk contoh terperinci, lihat Contoh skrip rs.exe Reporting Services untuk menyalin konten antar server laporan.