Доступ к поставщику WMI служб Reporting Services

Поставщик WMI служб Reporting Services отображает два класса WMI для администрирования экземпляров серверов отчетов, работающих в собственном режиме, путем создания сценариев:

Важно!

Начиная с выпуска SQL Server 2012 (11.x), поставщик WMI поддерживается только для серверов отчетов, работающих в собственном режиме. Серверы отчетов служб в режиме интеграции с SharePoint могут управляться со страниц центра администрирования SharePoint и с помощью скриптов PowerShell.

Класс	Пространство имен	Description
MSReportServer_Instance	root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v13	Основные сведения, необходимые клиенту для подключения к установленному серверу отчетов.
MSReportServer_ConfigurationSetting	root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v13\Admin	Представляет установочные параметры и параметры времени выполнения для экземпляра сервера отчетов. Эти параметры хранятся в файле конфигурации для сервера отчетов. ** Важно ** Этот класс доступен только для пользователей с правами администратора.

Экземпляр каждого из перечисленных выше классов создается для каждого экземпляра сервера отчетов. Для доступа к объектам WMI, предоставляемым сервером отчетов, можно использовать любые средства Майкрософт или не Майкрософт, включая интерфейсы программирования WMI, предоставляемые самим платформа .NET Framework. В этой статье описывается, как получить доступ к экземплярам класса WMI и использовать их с помощью команды PowerShell Get-WmiObject.

Определение имени экземпляра в строке пространства имен

Имя экземпляра в пути к пространству имен для классов WMI служб Reporting Services представляет собой кодировку имен экземпляра, которая указывается вами при установке именованных экземпляров служб Reporting Services. Конкретно в именах экземплярах кодируются специальные символы. Например, подчеркивание (_) закодировано как _5f, поэтому имя экземпляра My_Instance закодировано как My_5fInstance в пути пространства имен WMI.

Для просмотра списка закодированных имен экземпляров вашего сервера отчетов в пути к пространству имен WMI используйте следующую команду PowerShell:

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

Доступ к классам WMI с помощью PowerShell

Для получения доступа к классам WMI выполните следующую команду:

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

Например, для получения доступа к классу MSReportServer_ConfigurationSetting на экземпляре сервера отчетов по умолчанию узла myrshost, выполните следующую команду: Для успешного выполнения данной команды необходимо, чтобы экземпляр сервера отчетов по умолчанию был установлен на узле myrshost.

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

Синтаксис данной команды выводит все имена и значения свойств класса. Возвращаются все экземпляры класса MSReportServer_ConfigurationSetting, даже если вы обращаетесь к классу в пространстве имен экземпляра сервера отчетов по умолчанию (RS_MSSQLSERVER). Например, myrshost может быть установлен с экземпляром сервера отчетов по умолчанию и именованным экземпляром сервера отчетов с именем SHAREPOINT. Эта команда возвращает два объекта WMI и выводит имена и значения свойств для экземпляров сервера отчетов.

Для возвращения определенного экземпляра класса при возвращении нескольких экземпляров, используйте параметр -Filter для фильтрации результатов на основании свойств с уникальными значениями, как, например, InstanceName. Например, чтобы вернуть только объект WMI для экземпляра сервера отчетов по умолчанию, используйте следующую команду:

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

Запрос доступных методов и свойств

Для просмотра доступных методов и свойств в одном из классов WMI служб Reporting Services примените результаты из команды Get-WmiObject в команду Get-Member. Например:

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

Использование метода или свойства WMI

Вы можете использовать доступные методы и свойства при наличии объектов WMI для классов служб Reporting Services. Например, при наличии именованного экземпляра сервера отчетов в режиме интеграции с SharePoint с названием SHAREPOINT можно использовать следующую последовательность команд для получения URL-адреса для сайта центра администрирования 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()  
  

Связанный контент

Справочник по библиотеке поставщиков WMI служб Reporting Services (SSRS)
Файл конфигурации RsReportServer.config