Accéder au fournisseur WMI de Reporting ServicesAccess the Reporting Services WMI Provider

Le fournisseur WMI de Reporting Services présente deux classes WMI pour l'administration des instances de serveur de rapports en mode natif par script :The Reporting Services WMI provider exposes two WMI classes for administration of Native mode report server instances through scripting:

Important

À compter de la version SQL Server 2012SQL Server 2012 , le fournisseur WMI est pris en charge uniquement pour les serveurs de rapports en mode natif.Starting with the SQL Server 2012SQL Server 2012 release, the WMI provider is supported for only native mode report servers. Les serveurs de rapports en mode SharePoint peuvent être gérés avec les scripts PowerShell et les pages de l'Administration centrale de SharePoint.SharePoint mode report servers can be managed with SharePoint Central Administration pages and PowerShell scripts.

ClasseClass Espace de nomsNamespace DescriptionDescription
MSReportServer_InstanceMSReportServer_Instance root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName >\v13root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v13 Fournit les informations de base nécessaires à un client pour établir la connexion à un serveur de rapports installé.Provides basic information required for a client to connect to an installed report server.
MSReportServer_ConfigurationSettingMSReportServer_ConfigurationSetting root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName >\v13\Adminroot\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v13\Admin Représente les paramètres d'installation et d'exécution d'une instance de serveur de rapports.Represents the installation and run-time parameters of a report server instance. Ces paramètres sont stockés dans le fichier de configuration du serveur de rapports.These parameters are stored in the configuration file for the report server.

** Important *\* Cette classe est accessible uniquement avec des privilèges d’administrateur.** Important *\* This class is only accessible with administrative privileges.

Une instance de chaque classe ci-dessus est créée pour chaque instance du serveur de rapports.An instance of each of the above classes is created for each report server instance. Vous pouvez utiliser tous les outils Microsoft ou tiers pour accéder aux objets WMI exposés par le serveur de rapports, notamment les interfaces de programmation WMI exposées par .NET framework lui-même.You can use any Microsoft or third party tools to access the WMI objects exposed by the report server, including WMI programming interfaces exposed by the .NET Framework itself. Cette rubrique décrit comment accéder aux instances de classes WMI, et les utiliser, avec la commande PowerShell Get-WmiObject.This topic describes how to access and use the WMI class instances with the PowerShell command Get-WmiObject.

Déterminez le nom de l'instance dans la chaîne de l'espace de nomsDetermine the Instance Name in the Namespace String

Le nom de l'instance dans le chemin d'accès de l'espace de noms pour les classes WMI de Reporting Services est un encodage des noms d'instance que vous spécifiez lors de l'installation des instances nommées Reporting Services.The instance name in the namespace path for the Reporting Services WMI classes is an encoding of the instance names that you specify when installing the named Reporting Services instances. À savoir, les caractères spéciaux dans les noms d'instance sont encodés.Namely, special characters in the instance names are encoded. Par exemple, un soulignement () est encodé sous la forme « _5f », ce nom d'instance « My_Instance » est encodé en tant que « My_5fInstance » dans le chemin d'accès de l'espace de noms WMI.For example, an underline () is encoded as “_5f”, so an instance name of “My_Instance” is encoded as “My_5fInstance” in the WMI namespace path.

Pour répertorier les noms d'instance encodés de vos instances de serveur de rapports dans le chemin d'accès de l'espace de noms WMI, utilisez la commande suivante PowerShell :To list the encoded instance names of your report server instances in the WMI namespace path, use the following PowerShell command:

PS C:\windows\system32> Get-WmiObject –namespace root\Microsoft\SqlServer\ReportServer  –class __Namespace –ComputerName hostname | select Name  

Accédez aux classes WMI à l'aide de PowerShellAccess the WMI Classes Using PowerShell

Pour accéder aux classes WMI, exécutez la commande suivante :To access the WMI classes, run the following command:

PS C:\windows\system32> Get-WmiObject –namespace <namespacename> –class <classname> –ComputerName <hostname>  

Par exemple, pour accéder à la classe MSReportServer_ConfigurationSetting sur l'instance de serveur de rapports par défaut de l'hôte myrshost, exécutez la commande suivante.For example, to access the MSReportServer_ConfigurationSetting class on the default report server instance of the host myrshost, run the following command. L'instance du serveur de rapports par défaut doit être installée sur myrshost pour que cette commande réussisse.The default report server instance must be installed on myrshost for this command to succeed.

PS C:\windows\system32> Get-WmiObject –namespace "root\Microsoft\SqlServer\ReportServer\RS_MSSQLSERER\v11\Admin" -class MSReportServer_ConfigurationSetting -ComputerName myrshost  

Cette syntaxe de commande génère tous les noms et valeurs de propriété de classe.This command syntax outputs all class property names and values. Notez que toutes les instances de la classe MSReportServer_ConfigurationSetting sont retournées, même si vous accédez à la classe dans l'espace de noms de l'instance de serveur de rapports par défaut (RS_MSSQLSERVER).Note that all instances of the class MSReportServer_ConfigurationSetting is returned, even though you are accessing the class in the namespace of the default report server instance (RS_MSSQLSERVER). Par exemple, si myrshost est installé avec l'instance de serveur de rapports par défaut et une instance du serveur de rapports nommée appelées SHAREPOINT, cette commande retourne deux objets WMI et génère les noms et valeurs des propriétés pour les deux instances du serveur de rapports.For example, if myrshost is installed with the default report server instance and a named report server instance called SHAREPOINT, this command will return two WMI objects and output the property names and values for both report server instances.

Pour retourner une instance de la classe spécifique lorsque plusieurs instances sont retournées, utilisez le paramètre –Filter pour filtrer les résultats selon des propriétés avec des valeurs uniques comme InstanceName.To return a specific class instance when multiple instances are returned, use the –Filter parameter to filter the results based on properties with unique values such as InstanceName. Par exemple, pour retourner uniquement l'objet WMI pour l'instance de serveur de rapports par défaut, utilisez la commande suivante :For example, to return only the WMI object for the default report server instance, use the following command:

PS C:\windows\system32> Get-WmiObject -namespace "root\Microsoft\SqlServer\ReportServer\RS_MSSQLServer\v13\Admin" -class MSReportServer_ConfigurationSetting -ComputerName myrshost -filter "InstanceName='MSSQLSERVER'"  

Interrogez les méthodes et les propriétés disponiblesQuery the Available Methods and Properties

Pour connaître les méthodes et propriétés disponibles dans l'une des classes WMI de Reporting Services, acheminez les résultats de Get-WmiObject vers la commande Get-Member.To see what methods and properties are available in one of the Reporting Services WMI classes, pipe the results from Get-WmiObject to the Get-Member command. Par exemple :For example:

PS C:\windows\system32> Get-WmiObject -namespace "root\Microsoft\SqlServer\ReportServer\RS_MSSQLServer\v13\Admin" -class MSReportServer_ConfigurationSetting -ComputerName myrshost | Get-Member  

Utilisez une propriété ou une méthode WMIUse a WMI Method or Property

une fois que vous avez les objets WMI dans les classes de Reporting Services et que vous connaissez les propriétés et les méthodes disponibles, vous pouvez utiliser ces méthodes et propriétés.Once you have the WMI objects to the Reporting Services classes and know the available methods and properties, you can use these methods and properties. Par exemple, si vous avez une instance de serveur de rapports nommée dans le mode intégré SharePoint appelée SHAREPOINT, utilisez la séquence de commande suivante pour récupérer l'URL pour le site Administration centrale de SharePoint :For example, if you have a named report server instance in SharePoint integrated mode called SHAREPOINT, use the following command sequence to retrieve the URL for the SharePoint Central Administration site:

PS C:\windows\system32> $rsconfig = Get-WmiObject -namespace "root\Microsoft\SqlServer\ReportServer\RS_MSSQLServer\v13\Admin" -class MSReportServer_ConfigurationSetting -ComputerName myrshost -filter "InstanceName='SHAREPOINT'"  
PS C:\windows\system32> $rsconfig.GetAdminSiteUrl()  

Voir aussiSee Also

Référence de bibliothèque du fournisseur WMI de Reporting Services (SSRS) Reporting Services WMI Provider Library Reference (SSRS)
Fichier de configuration RSReportServer.configRsReportServer.config Configuration File