utilitas RS.exe (SSRS)

  • Artikel

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 .

-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 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.

-ppassword
(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.

- Akutime_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.

-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 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 bernamadengan 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.

Konten terkait