Accéder au fournisseur WMI de Reporting Services

  • Article

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 :

Important

À compter de SQL Server 2012 (11.x), le fournisseur WMI est pris en charge uniquement pour les serveurs de rapports en mode natif. 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.

Classe Espace de noms Description
MSReportServer_Instance root\Microsoft\SqlServer\ReportServer\RS_<NomInstanceEncodé>\v13 Fournit les informations de base nécessaires à un client pour établir la connexion à un serveur de rapports installé.
MSReportServer_ConfigurationSetting root\Microsoft\SqlServer\ReportServer\RS_<NomInstanceEncodé>\v13\Admin Représente les paramètres d'installation et d'exécution d'une instance de serveur de rapports. Ces paramètres sont stockés dans le fichier de configuration du serveur de rapports.

** Important ** Cette classe est accessible uniquement avec des privilèges d’administrateur.

Une instance de chaque classe ci-dessus est créée pour chaque instance du serveur de rapports. Vous pouvez utiliser tous les outils Microsoft ou non Microsoft 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. Cet article décrit comment accéder aux instances de classes WMI, et les utiliser, avec la commande PowerShell Get-WmiObject.

Déterminer le nom de l’instance dans la chaîne de l’espace de noms

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. À savoir, les caractères spéciaux dans les noms d'instance sont encodés. Par exemple, un trait de soulignement (_) étant encodé comme _5f, le nom d’instance My_Instance est encodé comme My_5fInstance dans le chemin de l’espace de noms WMI.

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 :

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

Accéder aux classes WMI à l’aide de PowerShell

Pour accéder aux classes WMI, exécutez la commande suivante :

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. L'instance du serveur de rapports par défaut doit être installée sur myrshost pour que cette commande réussisse.

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. 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). Par exemple, myrshost peut être installé avec l’instance de serveur de rapports par défaut et une instance nommée de serveur de rapports appelée SHAREPOINT. Cette commande retourne deux objets WMI et génère les noms et valeurs des propriétés pour les deux instances de serveur de rapports.

Pour retourner une instance de classe spécifique quand plusieurs instances sont retournées, utilisez le paramètre –Filter pour filtrer les résultats en fonction de propriétés à valeurs uniques comme InstanceName. Par exemple, pour retourner uniquement l'objet WMI pour l'instance de serveur de rapports par défaut, utilisez la commande suivante :

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

Interroger les méthodes et les propriétés disponibles

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. Par exemple :

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

Utiliser une propriété ou une méthode WMI

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

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()

Contenu connexe

Référence de bibliothèque du fournisseur WMI de Reporting Services (SSRS)
Fichier de configuration RsReportServer.config