RS.exe Utility (SSRS)RS.exe Utility (SSRS)

L'utilitaire rs.exe traite le script que vous fournissez dans un fichier d'entrée.The rs.exe utility processes script that you provide in an input file. Utilisez cet utilitaire pour automatiser les tâches de déploiement et d'administration du serveur de rapports.Use this utility to automate report server deployment and administration tasks.

Note

Depuis SQL Server 2008 R2SQL 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.Beginning with SQL Server 2008 R2SQL Server 2008 R2, the rs utility is supported against report servers that are configured for SharePoint integrated mode as well as servers configured in native mode. Les versions antérieures ne prenaient en charge que les configurations en mode natif.Previous versions only supported native mode configurations.

SyntaxeSyntax


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

Emplacement du fichier File Location

RS.exe se trouve à l’emplacement \Program Files\Microsoft SQL Server\110\Tools\Binn.RS.exe is located at \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.You can run the utility from any folder on your file system.

Arguments Arguments

-?-?
(Facultatif) Affiche la syntaxe des arguments de rs .(Optional) Displays the syntax of rs arguments.

-i input_file-i input_file
(Obligatoire) Spécifie le fichier .rss à exécuter.(Required) Specifies the .rss file to execute. Cette valeur peut être un chemin d'accès relatif ou totalement défini au fichier .rss.This value can be a relative or fully qualified path to the .rss file.

-s URL_serveur-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.(Required) Specifies the Web server name and report server virtual directory name to execute the file against. L'URL du serveur de rapports pourrait être par exemple http://examplewebserver/reportserver.An example of a report server URL is http://examplewebserver/reportserver. Le préfixe http:// ou https:// placé au début du nom du serveur est facultatif.The prefix http:// or https:// at the beginning of the server name is optional. 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.If you omit the prefix, the report server script host tries to use https first, and then uses http if https does not work.

-u [domaine\]nom_utilisateur-u [domain\]username
(Facultatif) Spécifie un compte d'utilisateur utilisé pour se connecter au serveur de rapports.(Optional) Specifies a user account used to connect to the report server. Si -u et -p sont absents, le compte d’utilisateur Windows actuel est utilisé.If -u and -p are omitted, the current Windows user account is used.

-p mot_de_passe-p password
(Obligatoire si -u est spécifié) Spécifie le mot de passe à utiliser avec l’argument -u .(Required if -u is specified) Specifies the password to use with the -u argument. Cette valeur respecte la casse.This value is case-sensitive.

-e-e
(Facultatif) Spécifie le point de terminaison SOAP sur lequel le script devrait s'exécuter.(Optional) Specifies the SOAP endpoint against which the script should run. Les valeurs suivantes sont valides :Valid values are the following:

  • Mgmt2010Mgmt2010

  • Mgmt2006Mgmt2006

  • Mgmt2005Mgmt2005

  • Exec2005Exec2005

    Si une valeur n'est pas spécifiée, le point de terminaison Mgmt2005 est utilisé.If a value is not specified, the Mgmt2005 endpoint is used. Pour plus d'informations sur les points de terminaison SOAP, consultez Report Server Web Service Endpoints.For more information about the SOAP endpoints, see Report Server Web Service Endpoints.

    -l time_out-l time_out
    (Facultatif) Spécifie le délai d'expiration de la connexion au serveur, en secondes.(Optional) Specifies the number of seconds that elapse before the connection to the server times out. La valeur par défaut est 60 secondes.The default is 60 seconds. Si vous ne spécifiez pas de délai d'expiration, la valeur par défaut est utilisée.If you do not specify a time-out value, the default is used. La valeur 0 indique que la connexion n'arrive jamais à expiration.A value of 0 specifies that the connection never times out.

    -b-b
    (Facultatif) Spécifie que les commandes du fichier script s'exécutent dans un lot.(Optional) Specifies that the commands in the script file run in a batch. En cas d'échec d'une commande, l'ensemble du lot est annulé.If any commands fail, the batch is rolled back. Certaines commandes ne peuvent pas être traitées par lot ; leur exécution se déroule normalement.Some commands cannot be batched, and those run as usual. Seules les exceptions générées qui ne sont pas gérées par le code du script entraînent une annulation.Only exceptions that are thrown and are not handled within the script result in a rollback. Si le script gère une exception et si l'exécution se poursuit normalement à partir de Main, le traitement est validé.If the script handles an exception and returns normally from Main, the batch is committed. Si vous omettez ce paramètre, les commandes s'exécutent sans créer de lot.If you omit this parameter, the commands run without creating a batch. Pour plus d’informations, voir Batching Methods.For more information, see Batching Methods.

    -v variable_globale-v globalvar
    (Facultatif) Spécifie les variables globales utilisées dans le script.(Optional) Specifies global variables that are used in the script. Si le script utilise des variables globales, vous devez spécifier cet argument.If the script uses global variables, you must specify this argument. La valeur que vous spécifiez doit être une valeur correcte définie dans le fichier .rss pour les variables globales.The value that you specify must be valid for global variable defined in the .rss file. Vous devez spécifier une variable globale pour chaque argument –v .You must specify one global variable for each –v argument.

    L’argument -v est spécifié sur la ligne de commande et il sert à configurer la valeur pour une variable globale définie dans votre script au moment de l’exécution.The -v argument is specified on the command line and is used to set the value for a global variable that is defined in your script at run time. 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 :For example, if your script contains a variable named parentFolder, you can specify a name for that folder on the command line:

    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.Global variables are created with the names given and set to the values supplied. Par exemple, -v a="1" -v b="2" a pour résultat une variable nommée a avec une valeur "1" et une variable b avec une valeur "2".For example, -v a="1" -v b="2" results in a variable named a with a value of"1" and a variable b with a value of "2".

    Les variables globales sont accessibles à n'importe quelle fonction du script.Global variables are available to any function in the script. Une barre oblique inverse suivie d’un guillemet (\") est interprétée comme un guillemet double.A backslash and quotation mark (\") is interpreted as a double quotation mark. Les guillemets sont obligatoires uniquement si la chaîne contient un espace.The quotation marks are required only if the string contains a space. Les noms de variables doivent être valides pour MicrosoftMicrosoft Visual BasicVisual 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.Variable names must be valid for MicrosoftMicrosoft Visual BasicVisual Basic; they must start with alphabetical character or underscore and contain alphabetical characters, digits, or underscores. Les mots réservés ne peuvent pas être utilisés en tant que noms de variables.Reserved words cannot be used as variable names. Pour plus d’informations sur l’utilisation de variables globales, consultez Collections intégrées dans les expressions (Générateur de rapports et SSRS).For more information about using global variables, see Built-in Collections in Expressions (Report Builder and SSRS).

    -t-t
    (Facultatif) Génère des messages d'erreur dans le journal des traces.(Optional) Outputs error messages to the trace log. Cet argument ne prend pas de valeur.This argument does not take a value. Pour plus d’informations, consultez Report Server Service Trace Log.For more information, see Report Server Service Trace Log.

Permissions Permissions

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.To run the tool, you must have permission to connect to the report server instance you are running the script against. Vous pouvez exécuter des scripts pour apporter des modifications à l'ordinateur local ou à un ordinateur distant.You can run scripts to make changes to the local computer or a remote computer. Pour apporter des modifications à un serveur de rapports installé sur un ordinateur distant, spécifiez l’ordinateur distant dans l’argument -s .To make changes to a report server installed on a remote computer, specify the remote computer in the -s argument.

Exemples Examples

L'exemple ci-dessous montre comment spécifier le fichier de script qui contient un script Visual BasicVisual Basic .NET et les méthodes du service Web que vous souhaitez exécuter.The following example illustrates how to specify the script file that contains Visual BasicVisual Basic .NET script and Web service methods that you want to execute.

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

Pour obtenir un exemple détaillé, consultez Exemple de script Reporting Services rs.exe pour copier du contenu entre des serveurs de rapports.For a detailed example, see Sample Reporting Services rs.exe Script to Copy Content between Report Servers.

Pour obtenir des exemples supplémentaires, consultez Exécuter un fichier de script Reporting Services.For additional examples, see Run a Reporting Services Script File

NotesRemarks

Vous pouvez créer des scripts pour définir des propriétés système, publier des rapports, etc.You can define scripts to set system properties, publish reports, and so forth. Les scripts que vous créez peuvent inclure toutes les méthodes de l'API Reporting ServicesReporting Services .The scripts that you create can include any methods of the Reporting ServicesReporting Services API. Pour plus d'informations sur les méthodes et les propriétés disponibles, consultez Report Server Web Service.For more information about the methods and properties available to you, see Report Server Web Service.

Le script doit être écrit en code Visual BasicVisual Basic .NET et stocké dans un fichier texte au format Unicode ou UTF-8, avec l’extension de nom de fichier .rss.The script must be written in Visual BasicVisual Basic .NET code, and stored in a Unicode or UTF-8 text file with an .rss file name extension. Vous ne pouvez pas déboguer les scripts à l’aide de l’utilitaire rs .You cannot debug scripts with the rs utility. Pour déboguer un script, exécutez le code dans MicrosoftMicrosoft Visual StudioVisual Studio.To debug a script, run the code within MicrosoftMicrosoft Visual StudioVisual Studio.

Voir aussiSee Also