Obtener acceso al proveedor WMI de Reporting ServicesAccess the Reporting Services WMI Provider

El proveedor WMI de Reporting Services expone dos clases de WMI para administrar instancias del servidor de informes en modo nativo mediante scripts:The Reporting Services WMI provider exposes two WMI classes for administration of Native mode report server instances through scripting:

Importante

A partir de la versión de SQL Server 2012SQL Server 2012 , el proveedor WMI se admite para los servidores de informes en modo nativo.Starting with the SQL Server 2012SQL Server 2012 release, the WMI provider is supported for only native mode report servers. Los servidores de informes en modo de SharePoint pueden administrarse con las páginas de Administración central de SharePoint y scripts de PowerShell.SharePoint mode report servers can be managed with SharePoint Central Administration pages and PowerShell scripts.

ClaseClass Espacio de nombresNamespace DescriptionDescription
MSReportServer_InstanceMSReportServer_Instance root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName >\v13root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v13 Proporciona la información básica requerida para que un cliente se conecte a un servidor de informes instalado.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 Representa la instalación y los parámetros de tiempo de ejecución de una instancia del servidor de informes.Represents the installation and run-time parameters of a report server instance. Estos parámetros se guardan en el archivo de configuración del servidor de informes.These parameters are stored in the configuration file for the report server.

** Importante *\* Esta clase solo está disponible con privilegios de administrador.** Important *\* This class is only accessible with administrative privileges.

Se crea una instancia de cada una de las clases anteriores para cada instancia del servidor de informes.An instance of each of the above classes is created for each report server instance. Puede utilizar cualquier herramienta de Microsoft o de terceros para tener acceso a los objetos de WMI expuestos por el servidor de informes, incluidas las interfaces de programación de WMI, expuestas por .NET Framework.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. En este tema se describe cómo acceder y usar las instancias de clases WMI con el comando de PowerShell Get-WmiObject.This topic describes how to access and use the WMI class instances with the PowerShell command Get-WmiObject.

Determinar el nombre de instancia en la cadena del espacio de nombresDetermine the Instance Name in the Namespace String

El nombre de instancia de la ruta de acceso del espacio de nombres para las clases de WMI de Reporting Services es una codificación de los nombres de instancia especificados al instalar las instancias con nombre de 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. Concretamente, los caracteres especiales en los nombres de instancia se codifican.Namely, special characters in the instance names are encoded. Por ejemplo, el carácter de subrayado () se codifica como “_5f”, por lo que el nombre de instancia “My_Instance” se codificará como “My_5fInstance” en la ruta de acceso del espacio de nombres de 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.

Para enumerar los nombres de instancia codificados de las instancias del servidor de informes en la ruta de acceso del espacio de nombres de WMI, utilice el siguiente comando de 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  

Obtener acceso a clases de WMI mediante PowerShellAccess the WMI Classes Using PowerShell

Para obtener acceso a las clases de WMI, ejecute el siguiente comando:To access the WMI classes, run the following command:

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

Por ejemplo, para tener acceso a la clase MSReportServer_ConfigurationSetting en la instancia predeterminada del servidor de informes del host myrshost, ejecute el siguiente comando.For example, to access the MSReportServer_ConfigurationSetting class on the default report server instance of the host myrshost, run the following command. La instancia predeterminada del servidor de informes se debe instalar en myrshost para que el comando se ejecute correctamente.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  

Esta sintaxis de comando genera todos los nombres de propiedad y valores de la clase.This command syntax outputs all class property names and values. Observe que se devuelven todas las instancias de la clase MSReportServer_ConfigurationSetting, aunque esté obteniendo acceso a la clase en el espacio de nombres de la instancia predeterminada del servidor de informes (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). Por ejemplo, si myrshost se instala con la instancia predeterminada del servidor de informes y una instancia con nombre del servidor de informes denominada SHAREPOINT, este comando devolverá dos objetos de WMI y generará los nombres de propiedad y valores para ambas instancias del servidor de informes.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.

Para que se devuelva una instancia de clase específica cuando se devuelven varias instancias, utilice el parámetro -–Filter para filtrar los resultados en función de propiedades con valores únicos, como 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. Por ejemplo, para devolver solo el objeto de WMI de la instancia predeterminada del servidor de informes, use el siguiente comando: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'"  

Consultar los métodos y propiedades disponiblesQuery the Available Methods and Properties

Para ver qué métodos y propiedades están disponibles en una de las clases de WMI de Reporting Services, canalice los resultados desde Get-WmiObject al comando 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. Por ejemplo:For example:

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

Utilizar un método o propiedad de WMIUse a WMI Method or Property

Una vez tenga los objetos de WMI en las clases de Reporting Services y conozca los métodos y propiedades disponibles, podrá usar esos métodos y propiedades.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. Por ejemplo, si tiene una instancia con nombre del servidor de informes en modo integrado de SharePoint denominada SHAREPOINT, use la siguiente secuencia de comandos para recuperar la dirección URL del sitio de Administración central 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()  

Vea tambiénSee Also

Referencia de la biblioteca de proveedores WMI de Reporting Services (SSRS) Reporting Services WMI Provider Library Reference (SSRS)
Archivo de configuración RsReportServer.configRsReportServer.config Configuration File