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, 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.
Dalam topik ini:
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 \Program Files\Microsoft SQL Server\110\Tools\Binn. Anda dapat menjalankan utilitas dari folder apa pun di sistem file Anda.
Argumen
-?
(Opsional) Menampilkan sintaks argumen rs .
-iinput_file
(Diperlukan) Menentukan file .rss yang akan dijalankan. Nilai ini dapat menjadi jalur relatif atau sepenuhnya memenuhi syarat ke file .rss.
-sserverURL
(Diperlukan) Menentukan nama server Web dan nama direktori virtual server laporan untuk menjalankan file. Contoh URL server laporan adalah http://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.
-pkata sandi
(Diperlukan jika -u ditentukan) Menentukan kata sandi yang akan digunakan dengan -u argumen . Nilai ini peka huruf besar/kecil.
-e
(Opsional) Menentukan titik akhir SOAP tempat skrip harus dijalankan. Nilai yang valid adalah sebagai berikut:
Mgmt2010
Mgmt2006
Mgmt2005
Exec2005
Jika nilai tidak ditentukan, titik akhir Mgmt2005 digunakan. Untuk informasi selengkapnya tentang titik akhir SOAP, lihat Titik Akhir Layanan Web Server Laporan.
-ltime_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 Main, batch diterapkan. Jika Anda menghilangkan parameter ini, perintah berjalan tanpa membuat batch. Untuk informasi selengkapnya, lihat Metode Batching.
-vglobalvar
(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 http://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 a 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 dicadangkan tidak dapat digunakan sebagai nama variabel. Untuk informasi selengkapnya tentang menggunakan variabel global, lihat Koleksi bawaan dalam Ekspresi (Pembuat Laporan 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 -s argumen.
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 Reporting Services rs.exe Skrip untuk Memigrasikan Konten antar Server Laporan.
Untuk contoh tambahan, 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 Layanan Web Server Laporan.
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 Reporting Services rs.exe Skrip untuk Memigrasikan Konten antar Server Laporan.
Lihat Juga
Menjalankan File Skrip Microsoft SQL Server Reporting Services
Penyebaran Skrip dan Tugas Administratif
Skrip dengan Utilitas rs.exe dan Layanan Web
Utilitas Prompt Perintah Server Laporan (SSRS)