Reporting Services WMI 공급자 액세스Access the Reporting Services WMI Provider

Reporting Services WMI 공급자는 스크립팅을 통해 기본 모드 보고서 서버 인스턴스를 관리하기 위해 두 WMI 클래스를 제공합니다.The Reporting Services WMI provider exposes two WMI classes for administration of Native mode report server instances through scripting:

중요

SQL Server 2012SQL Server 2012 릴리스부터는 WMI 공급자가 기본 모드 보고서 서버에 대해서만 지원됩니다.Starting with the SQL Server 2012SQL Server 2012 release, the WMI provider is supported for only native mode report servers. SharePoint 모드 보고서 서버는 SharePoint 중앙 관리 페이지 및 PowerShell 스크립트를 사용하여 관리할 수 있습니다.SharePoint mode report servers can be managed with SharePoint Central Administration pages and PowerShell scripts.

클래스Class 네임스페이스Namespace DescriptionDescription
MSReportServer_InstanceMSReportServer_Instance root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v13root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v13 클라이언트에서 설치된 보고서 서버에 연결하는 데 필요한 기본 정보를 제공합니다.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 보고서 서버 인스턴스의 설치 및 런타임 매개 변수를 나타냅니다.Represents the installation and run-time parameters of a report server instance. 이러한 매개 변수는 보고서 서버의 구성 파일에 저장됩니다.These parameters are stored in the configuration file for the report server.

** 중요 *\* 이 클래스는 관리 권한이 있어야만 액세스할 수 있습니다.** Important *\* This class is only accessible with administrative privileges.

각 보고서 서버 인스턴스에 대해 위의 각 클래스 인스턴스가 만들어집니다.An instance of each of the above classes is created for each report server instance. 모든 Microsoft 또는 타사 도구를 사용하여 .NET Framework 자체에서 제공하는 WMI 프로그래밍 인터페이스를 포함하여 보고서 서버에서 제공하는 WMI 개체에 액세스할 수 있습니다.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. 이 항목에서는 PowerShell 명령 Get-WmiObject를 사용하여 WMI 클래스 인스턴스에 액세스하고 사용하는 방법을 설명합니다.This topic describes how to access and use the WMI class instances with the PowerShell command Get-WmiObject.

네임스페이스 문자열에서 인스턴스 이름 결정Determine the Instance Name in the Namespace String

Reporting Services WMI 클래스의 네임스페이스 경로에 있는 인스턴스 이름은 명명된 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. 즉, 인스턴스 이름의 특수 문자가 인코딩됩니다.Namely, special characters in the instance names are encoded. 예를 들어 밑줄()은 "_5f"로 인코딩되어 인스턴스 이름 "My_Instance"는 WMI 네임스페이스 경로에서 "My_5fInstance"로 인코딩됩니다.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.

WMI 네임스페이스 경로에 보고서 서버 인스턴스의 인코딩된 인스턴스 이름을 나열하려면 다음 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  

PowerShell을 사용하여 WMI 클래스 액세스Access the WMI Classes Using PowerShell

WMI 클래스에 액세스하려면 다음 명령을 실행합니다.To access the WMI classes, run the following command:

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

예를 들어 myrshost 호스트의 기본 보고서 서버 인스턴스에서 MSReportServer_ConfigurationSetting 클래스에 액세스하려면 다음 명령을 실행합니다.For example, to access the MSReportServer_ConfigurationSetting class on the default report server instance of the host myrshost, run the following command. 이 명령을 제대로 수행하려면 기본 보고서 서버 인스턴스가 myrshost에 설치되어 있어야 합니다.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  

이 명령 구문은 모든 클래스 속성 이름 및 값을 출력합니다.This command syntax outputs all class property names and values. 기본 보고서 서버 인스턴스(RS_MSSQLSERVER)의 네임스페이스에서 클래스에 액세스하더라도 MSReportServer_ConfigurationSetting 클래스의 모든 인스턴스가 반환됩니다.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). 예를 들어 기본 보고서 서버 인스턴스 및 SHAREPOINT라는 명명된 보고서 서버 인스턴스와 함께 myrshost가 설치되어 있는 경우 이 명령은 두 WMI 개체를 반환하고 두 보고서 서버 인스턴스의 속성 이름과 값을 출력합니다.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.

여러 인스턴스가 반환되는 경우 특정 클래스 인스턴스를 반환하려면 –Filter 매개 변수를 사용하여 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. 예를 들어 기본 보고서 서버 인스턴스의 WMI 개체만 반환하려면 다음 명령을 사용합니다.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'"  

사용 가능한 메서드 및 속성 쿼리Query the Available Methods and Properties

Reporting Services WMI 클래스 중 하나에서 사용할 수 있는 메서드 및 속성을 보려면 Get-WmiObject의 결과를 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. 예를 들어For example:

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

WMI 메서드 또는 속성 사용Use a WMI Method or Property

Reporting Services 클래스에 대한 WMI 개체가 있고 사용 가능한 메서드와 속성을 알면 이러한 메서드와 속성을 사용할 수 있습니다.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. 예를 들어 SharePoint 통합 모드에 SHAREPOINT라는 명명된 보고서 서버 인스턴스가 있는 경우 다음 명령 시퀀스를 사용하여 SharePoint 중앙 관리 사이트의 URL을 검색합니다.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()  

관련 항목:See Also

Reporting Services WMI 공급자 라이브러리 참조(SSRS) Reporting Services WMI Provider Library Reference (SSRS)
RsReportServer.config 구성 파일RsReportServer.config Configuration File