Utilitaire RS.exe (SSRS)

 

S'applique à: SQL Server 2016

L'utilitaire rs.exe traite le script que vous fournissez dans un fichier d'entrée. Utilisez cet utilitaire pour automatiser les tâches de déploiement et d'administration du serveur de rapports.

System_CAPS_ICON_note.jpg Remarque


Depuis SQL Server 2008 R2, l’utilitaire rs est pris en charge sur les serveurs de rapports configurés pour le mode intégré SharePoint ainsi que sur les serveurs configurés en mode natif. Les versions antérieures ne prenaient en charge que les configurations en mode natif.

Dans cette rubrique :

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

RS.exe se trouve dans \Program Files\Microsoft SQL Server\110\Tools\Binn. Vous pouvez exécuter l'utilitaire à partir de n'importe quel dossier de votre système de fichiers.

-?
(Facultatif) Affiche la syntaxe de rs arguments.

i - input_file
(Obligatoire) Spécifie le fichier .rss à exécuter. Cette valeur peut être un chemin d'accès relatif ou totalement défini au fichier .rss.

s - serverURL
(Obligatoire) Spécifie les noms du serveur Web et du répertoire virtuel du serveur de rapports auxquels s'applique le fichier à exécuter. L'URL du serveur de rapports pourrait être par exemple http://examplewebserver/reportserver. Le préfixe http:// ou https:// placé au début du nom du serveur est facultatif. Si vous omettez le préfixe, l'environnement d'exécution de scripts du serveur de rapports tente en premier lieu d'utiliser https et, si cela ne fonctionne pas, il essaie avec http.

-u [domaine\]nom d’utilisateur
(Facultatif) Spécifie un compte d'utilisateur utilisé pour se connecter au serveur de rapports. Si -u et -p sont omis, le compte d’utilisateur Windows actuel est utilisé.

p - mot de passe
(Obligatoire si -u est spécifié) spécifie le mot de passe à utiliser avec le -u argument. Cette valeur respecte la casse.

-e
(Facultatif) Spécifie le point de terminaison SOAP sur lequel le script devrait s'exécuter. Les valeurs suivantes sont valides :

  • Mgmt2010

  • Mgmt2006

  • Mgmt2005

  • Exec2005

Si une valeur n'est pas spécifiée, le point de terminaison Mgmt2005 est utilisé. Pour plus d'informations sur les points de terminaison SOAP, consultez Report Server Web Service Endpoints.

-l time_out
(Facultatif) Spécifie le délai d'expiration de la connexion au serveur, en secondes. La valeur par défaut est 60 secondes. Si vous ne spécifiez pas de délai d'expiration, la valeur par défaut est utilisée. La valeur 0 indique que la connexion n'arrive jamais à expiration.

-b
(Facultatif) Spécifie que les commandes du fichier script s'exécutent dans un lot. En cas d'échec d'une commande, l'ensemble du lot est annulé. Certaines commandes ne peuvent pas être traitées par lot ; leur exécution se déroule normalement. Seules les exceptions générées qui ne sont pas gérées par le code du script entraînent une annulation. Si le script gère une exception et si l'exécution se poursuit normalement à partir de Main, le traitement est validé. Si vous omettez ce paramètre, les commandes s'exécutent sans créer de lot. Pour plus d’informations, voir Batching Methods.

v - globalvar
(Facultatif) Spécifie les variables globales utilisées dans le script. Si le script utilise des variables globales, vous devez spécifier cet argument. La valeur que vous spécifiez doit être une valeur correcte définie dans le fichier .rss pour les variables globales. Vous devez spécifier une variable globale pour chaque argument –v .

Le - v argument est spécifié sur la ligne de commande et est utilisé pour définir la valeur d’une variable globale définie dans votre script en cours d’exécution. Par exemple, si votre script contient une variable nommée parentFolder, vous pouvez spécifier un nom pour ce dossier sur la ligne de commande :

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

Les variables globales sont créées avec les noms donnés et prennent les valeurs fournies. Par exemple, - v un =»1» - v b =»2» entraîne une variable nommée un avec une valeur de »1» et une variable b avec une valeur de «2».

Les variables globales sont accessibles à n'importe quelle fonction du script. Une barre oblique inverse et un guillemet () est interprété comme un guillemet double. Les guillemets sont obligatoires uniquement si la chaîne contient un espace. Les noms de variables doivent être valides pour Microsoft Visual Basic; ils doivent commencer par un caractère alphabétique ou un trait de soulignement et ne contenir que des lettres, des nombres ou des traits de soulignement. Les mots réservés ne peuvent pas être utilisés en tant que noms de variables. Pour plus d’informations sur l’utilisation de variables globales, consultez Collections intégrées dans les Expressions & #40 ; SSRS & #41 ; et le Générateur de rapports.

-t
(Facultatif) Génère des messages d'erreur dans le journal des traces. Cet argument ne prend pas de valeur. Pour plus d’informations, consultez Report Server Service Trace Log.

Pour exécuter l'outil, vous devez avoir l'autorisation de vous connecter à l'instance du serveur de rapports sur laquelle s'exécute le script. Vous pouvez exécuter des scripts pour apporter des modifications à l'ordinateur local ou à un ordinateur distant. Pour apporter des modifications à un serveur de rapports installé sur un ordinateur distant, spécifiez l’ordinateur distant dans la -s argument.

L'exemple ci-dessous montre comment spécifier le fichier de script qui contient un script Visual Basic .NET et les méthodes du service Web que vous souhaitez exécuter.

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

Pour obtenir un exemple détaillé, consultez la page exemple Reporting Services rs.exe Script pour copier le contenu entre les serveurs de rapports.

Pour obtenir des exemples supplémentaires, consultez exécuter un fichier de Script Reporting Services

Vous pouvez créer des scripts pour définir des propriétés système, publier des rapports, etc. Les scripts que vous créez peuvent inclure toutes les méthodes de l'API Reporting Services . Pour plus d'informations sur les méthodes et les propriétés disponibles, consultez Report Server Web Service.

Le script doit être écrit en Visual Basic code .NET et stockées dans un fichier texte Unicode ou UTF-8 avec une extension de nom de fichier .rss. Vous ne pouvez pas déboguer les scripts à l’aide de l’utilitaire rs . Pour déboguer un script, exécutez le code dans Microsoft Visual Studio.

System_CAPS_ICON_tip.jpg Conseil


Pour obtenir un exemple détaillé, consultez la page exemple Reporting Services rs.exe Script pour copier le contenu entre les serveurs de rapports.

Exécuter un fichier de script Reporting Services
Écrire des scripts pour les tâches d'administration et de déploiement
Écrire des scripts avec l'utilitaire rs.exe et le service Web
Utilitaires d’invite de commande de serveur de rapports & #40 ; SSRS & #41 ;

Ajouts de la communauté

AJOUTER
Afficher: