Aracılığıyla paylaş

RS.exe yardımcı programı (SSRS)

rs.exe yardımcı programı, verdiğiniz bir giriş dosyasında bulunan betiği işler. Rapor sunucusu dağıtım ve yönetim görevlerini otomatikleştirmek için bu yardımcı programı kullanın.

Uyarı

SQL Server 2008 R2 (10.50.x) sürümünden başlayarak , rs yardımcı programı SharePoint tümleşik modu için yapılandırılan rapor sunucularında ve yerel modda yapılandırılmış sunucularda desteklenir. Önceki sürümler yalnızca yerel mod yapılandırmalarını destekliyor.

Sözdizimi

  
rs {-?}  
{-i input_file}  
{-s serverURL}  
{-u username}  
{-p password}  
{-e endpoint}  
{-l time_out}  
{-b batchmode}  
{-v globalvars=}  
{-t trace}

Dosya konumu

RS.exe , rapor sunucusu sürümüne bağlı olarak aşağıdaki klasörlerde bulunur. Yardımcı programı dosya sisteminizdeki herhangi bir klasörden çalıştırabilirsiniz.

Şunlar için geçerlidir: SQL Server Raporlama Hizmetleri (2016)

C:\Program Files (x86)\Microsoft SQL Server\130\Tools\Binn

Şunlar için geçerlidir: SQL Server Reporting Services (2017 ve sonraki sürümler)

C:\Program Files\Microsoft SQL Server Reporting Services\Shared Tools

Şunlar için geçerlidir: Power BI Rapor Sunucusu

C:\Program Files\Microsoft Power BI Report Server\Shared Tools

Arguments

-?
(İsteğe bağlı) Rs bağımsız değişkenlerinin söz dizimini görüntüler.

-iinput_file
(Gerekli) Yürütülecek .rss dosyasını belirtir. Bu değer, .rss dosyasının göreli veya tam olarak belirtilmiş yolu olabilir.

-sserverURL
(Gerekli) Dosyanın yürütülecek Web sunucusu adını ve rapor sunucusu sanal dizin adını belirtir. Rapor sunucusu URL'sine örnek olarak verilmiştir https://examplewebserver/reportserver. Sunucu adının başındaki önek http:// veya https:// isteğe bağlıdır. Ön eki atlarsanız, rapor sunucusu betik konağı önce https kullanmayı dener ve ardından https çalışmazsa http kullanır.

-u [etkialanı\]kullanıcıadı
(İsteğe bağlı) Rapor sunucusuna bağlanmak için kullanılan kullanıcı hesabını belirtir. -u ve -p belirtilmezse, geçerli Windows kullanıcı hesabı kullanılır.

-pparolası
( -u belirtilirse gereklidir) -u bağımsız değişkeniyle kullanılacak parolayı belirtir. Bu değer büyük küçük harfe duyarlıdır.

-e
(İsteğe bağlı) Betiğin çalışması gereken SOAP uç noktasını belirtir. Geçerli değerler şunlardır:

  • Mgmt2010

  • Mgmt2006

  • Mgmt2005

  • Exec2005

Bir değer belirtilmezse Mgmt2005 uç noktası kullanılır. SOAP uç noktaları hakkında daha fazla bilgi için bkz. Rapor sunucusu web hizmeti uç noktaları.

-ltime_out
(İsteğe bağlı) Sunucu bağlantısı zaman aşımına uğramadan önce geçen saniye sayısını belirtir. Varsayılan değer 60 saniyedir. Zaman aşımı değeri belirtmezseniz varsayılan değer kullanılır. 0 değeri, bağlantının asla zaman aşımına uğramayacağını belirtir.

-b
(İsteğe bağlı) Betik dosyasındaki komutların toplu olarak çalıştırıldığını belirtir. Herhangi bir komut başarısız olursa yığın geri alınır. Bazı komutlar toplu işlenemez ve bu komutlar her zamanki gibi çalışır. Yalnızca oluşan ve betik içinde işlenmemiş özel durumlar geri alma işlemiyle sonuçlanır. Betik bir özel durumu işler ve Main'e normal şekilde dönerse, işlemler gerçekleştirilir. Bu parametreyi atlarsanız komutlar toplu iş oluşturmadan çalışır. Daha fazla bilgi için Toplu işlem yöntemleri'ne bkz.

-vglobalvar
(İsteğe bağlı) Betikte kullanılan genel değişkenleri belirtir. Betik genel değişkenler kullanıyorsa, bu parametreyi belirtmeniz gerekir. Belirttiğiniz değer, .rss dosyasında tanımlanan genel değişken için geçerli olmalıdır. Her -v bağımsız değişkeni için bir genel değişken belirtmeniz gerekir.

-v bağımsız değişkeni komut satırında belirtilir ve çalışma zamanında betiğinizde tanımlanan genel değişkenin değerini ayarlamak için kullanılır. Örneğin, betiğiniz parentFolder adlı bir değişken içeriyorsa, komut satırında bu klasör için bir ad belirtebilirsiniz:

rs.exe -i myScriptFile.rss -s https://myServer/reportserver -v parentFolder="Financial Reports"

Genel değişkenler verilen adlarla oluşturulur ve sağlanan değerlere ayarlanır. Örneğin, -v a="1" -v b="2", "1" değerine sahip a adlı bir değişkene ve "2" değerine sahip b değişkenine neden olur.

Genel değişkenler betikteki herhangi bir işlev için kullanılabilir. Ters eğik çizgi ve tırnak işareti (\") çift tırnak işareti olarak yorumlanır. Dizede boşluk varsa, tırnak işaretleri sadece o zaman gereklidir. Değişken adları Microsoft Visual Basic için geçerli olmalıdır. Alfabetik bir karakter veya alt çizgi ile başlamalı ve alfabetik karakterler, rakamlar veya alt çizgi içermelidir. Ayrılmış sözcükler değişken adları olarak kullanılamaz. Genel değişkenleri kullanma hakkında daha fazla bilgi için bkz. İfadelerdeki yerleşik koleksiyonlar (Rapor Oluşturucusu ve SSRS).

-t
(İsteğe bağlı) hata iletilerini izleme günlüğüne aktarır. Bu bağımsız değişken bir değer almaz. Daha fazla bilgi için Rapor sunucusu hizmet izleme günlüğüne bkz.

Permissions

Aracı çalıştırmak için betiği çalıştırdığınız rapor sunucusu örneğine bağlanma izniniz olmalıdır. Yerel bilgisayarda veya uzak bilgisayarda değişiklik yapmak için betikleri çalıştırabilirsiniz. Uzak bilgisayarda yüklü bir rapor sunucusunda değişiklik yapmak için -s bağımsız değişkeninde uzak bilgisayarı belirtin.

Örnekler

Aşağıdaki örnek, yürütmek istediğiniz Visual Basic .NET betiğini ve Web hizmeti yöntemlerini içeren betik dosyasının nasıl belirtileceğini gösterir.

rs -i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver

Ayrıntılı bir örnek için Rapor sunucuları arasında içerik kopyalamak için Örnek Reporting Services rs.exe betiğine bakın.

Daha fazla örnek için bkz . Reporting Services betik dosyasını çalıştırma

Açıklamalar

Sistem özelliklerini ayarlamak, raporları yayımlamak vb. için betikler tanımlayabilirsiniz. Oluşturduğunuz betikler, Reporting Services API'sinin herhangi bir yöntemini içerebilir. Kullanabileceğiniz yöntemler ve özellikler hakkında daha fazla bilgi için bkz. Rapor sunucusu web hizmeti.

Betik Visual Basic .NET kodunda yazılmalıdır ve .rss dosya adı uzantısına sahip bir Unicode veya UTF-8 metin dosyasında depolanmalıdır. Rs yardımcı programıyla betiklerin hatalarını ayıklayamazsınız. Bir betiğin hatalarını ayıklamak için kodu Microsoft Visual Studio'da çalıştırın.

İpucu

Ayrıntılı bir örnek için Rapor sunucuları arasında içerik kopyalamak için Örnek Reporting Services rs.exe betiğine bakın.

İlgili içerik

  • Last updated on