PowerShell cmdlet(Reporting Services SharePoint 모드)

SQL Server 2012 Reporting Services SharePoint 모드를 설치하는 경우 SharePoint 모드에서 보고서 서버를 지원하기 위해 PowerShell cmdlet이 설치됩니다. cmdlet은 세 가지 범주의 기능을 포함합니다.

• Reporting Services SharePoint 공유 서비스 및 프록시 설치

• Reporting Services 서비스 응용 프로그램과 연결된 프록시의 프로비전 및 관리

• Reporting Services 기능(예: 확장 및 암호화 키) 관리

이 항목은 다음과 같이 구성되어 있습니다.

• Cmdlet Summary

• Shared Service Cmdlets

• Service Application Cmdlets

• Reporting Services functionality related Cmdlets

• Basic Samples

• Detailed Samples

  • Create a service application and proxy

  • Review and update a delivery extension

  • Get and set Properties of the Reporting Service Application Database

  • List Data Extensions

  • Change and list subscription owners

Cmdlet 요약

cmdlet을 실행하려면 SharePoint 관리 셸을 열어야 합니다. Microsoft Windows에 포함된 그래픽 사용자 인터페이스 편집기인 **Windows PowerShell ISE(통합 스크립팅 환경)**를 사용할 수도 있습니다. 자세한 내용은 Windows Server에서 Windows PowerShell 시작(https://technet.microsoft.com/library/hh847814.aspx)을 참조하세요. 다음 cmdlet 요약에서 서비스 응용 프로그램에 대한 참조인 ‘databases’는 Reporting Services 서비스 응용 프로그램에서 만들고 사용하는 모든 데이터베이스를 말합니다. 여기에는 구성, 경고 및 임시 데이터베이스가 포함됩니다.

PowerShell 예를 입력할 때 다음과 비슷한 오류 메시지가 표시됩니다.

• Install-SPRSService : 'Install-SPRSService' 용어는 cmdlet, 함수, 스크립트 파일 또는 실행 프로그램의 이름으로 인식되지 않습니다. 경로가 올바른지 확인한 다음 다시 시도하십시오.

다음 문제 중 하나가 발생합니다.

• Reporting Services SharePoint 모드가 설치되어 있지 않으므로 Reporting Services cmdlet이 설치되지 않았습니다.

• SharePoint 관리 셸 대신 Windows PowerShell 또는 Windows PowerShell ISE에서 PowerShell 명령을 실행했습니다. SharePoint 관리 셸을 사용하거나 다음 명령을 사용하여 Windows PowerShell 창에 SharePoint 스냅인을 추가합니다.

  Add-PSSnapin Microsoft.SharePoint.PowerShell
  

자세한 내용은 Windows PowerShell을 사용하여 SharePoint 2013 관리(https://technet.microsoft.com/library/ee806878.aspx)를 참조하세요.

SharePoint 관리 셸을 열고 cmdlet을 실행하려면

1. 시작 단추를 클릭합니다.

2. Microsoft SharePoint 제품 그룹을 클릭합니다.

3. SharePoint 관리 셸을 클릭합니다.

cmdlet의 명령줄 도움말을 보려면 PowerShell 명령 프롬프트에서 PowerShell ‘Get-Help’ 명령을 사용합니다. 예를 들어 다음과 같습니다.

Get-Help Get-SPRSServiceApplicationServers

Top

공유 서비스 및 프록시 Cmdlet

다음 표에는 Reporting Services SharePoint 공유 서비스에 대한 PowerShell cmdlet이 나와 있습니다.

Top

서비스 응용 프로그램 및 프록시 Cmdlet

다음 표에는 Reporting Services 서비스 응용 프로그램과 관련 프록시에 대한 PowerShell cmdlet이 나와 있습니다.

Top

Reporting Services 사용자 지정 기능 Cmdlet

기본 예제

이름에 'SPRS'가 포함된 cmdlet 목록을 반환합니다. 이 목록은 Reporting Services cmdlet의 전체 목록입니다.

Get-command –noun *SPRS*

자세히 말해서 commandlist.txt라는 텍스트 파일로 전달됩니다.

Get-command -noun *SPRS*| select name, definition |Format-list | Out-File c:\commandlist.txt

Reporting Services SharePoint 서비스 및 서비스 프록시를 설치합니다.

Install-SPRSService

Install-SPRSServiceProxy

Reporting Services 서비스 시작

get-spserviceinstance -all |where {$_.TypeName -like "SQL Server Reporting*"} | Start-SPServiceInstance

로그 파일에서 필터링된 행 목록을 반환하려면 SharePoint 관리 셸에서 다음 명령을 입력합니다. 이 명령은 "ssrscustomactionerror"가 포함된 행에 대해 필터링합니다. 이 예제에서는 rssharepoint.msi를 설치할 때 만든 로그 파일을 찾습니다.

Get-content -path C:\Users\testuser\AppData\Local\Temp\rs_sp_0.log | select-string "ssrscustomactionerror"

Top

자세한 예제

다음 예제와 함께 (Steps 1-4) Windows PowerShell script for Steps 1–4 항목의 "Windows PowerShell 스크립트" 섹션을 참조하세요.

서비스 응용 프로그램 및 프록시 만들기

이 예제 스크립트는 다음 태스크를 완료합니다.

1. Reporting Services 서비스 응용 프로그램 및 프록시를 만듭니다. 이 스크립트는 "My App Pool" 응용 프로그램 풀이 이미 있는 것으로 가정합니다.

2. 기본 프록시 그룹에 프록시 추가

3. 포트 80 웹 응용 프로그램의 콘텐츠 데이터베이스에 대한 서비스 응용 프로그램 액세스를 허용합니다. 이 스크립트는 "http://sitename" 사이트가 이미 있다고 가정합니다.

# Create service application and service application proxy
$appPool = Get-SPServiceApplicationPool “My App Pool”
$serviceApp = New-SPRSServiceApplication “My RS Service App” –ApplicationPool $appPool
$serviceAppProxy = New-SPRSServiceApplicationProxy –Name “My RS Service App Proxy” –ServiceApplication $serviceApp

# Add service application proxy to default proxy group.  Any web application that uses the default proxy group will now be able to use this service application.
Get-SPServiceApplicationProxyGroup –default | Add-SPServiceApplicationProxyGroupMember –Member $serviceAppProxy

# Grant application pool account access to the port 80 web application’s content database.
$webApp = Get-SPWebApplication “http://sitename”
$appPoolAccountName = $appPool.ProcessAccount.LookupName()
$webApp.GrantAccessToProcessIdentity($appPoolAccountName)

배달 확장 검토 및 업데이트

다음 PowerShell 스크립트 예에서 "ssrs_testapp"My RS Service App 서비스 응용 프로그램에 대해 보고서 서버 전자 메일 배달 확장 프로그램의 구성을 업데이트합니다. SMTP 서버 이름(<email server name>) 및 FROM 전자 메일 별칭(<your FROM email address>) 값을 업데이트합니다.

$app=get-sprsserviceapplication -Name "My RS Service App"
$emailCfg = Get-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml 
$emailXml = [xml]$emailCfg 
$emailXml.SelectSingleNode("//SMTPServer").InnerText = “<email server name>”
$emailXml.SelectSingleNode("//SendUsing").InnerText = "2"
$emailXml.SelectSingleNode("//SMTPAuthenticate").InnerText = "2"
$emailXml.SelectSingleNode("//From").InnerText = '<your FROM email address>'
Set-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" -ExtensionConfiguration $emailXml.OuterXml

위의 예에서 서비스 응용 프로그램의 정확한 이름을 모를 경우 부분 이름 검색을 기반으로 서비스 응용 프로그램을 가져오도록 첫 번째 문을 다시 작성할 수 있습니다. 예를 들어 다음과 같습니다.

$app=get-sprsserviceapplication | where {$_.name -like " My RS Ser *"}

다음 스크립트는 “My RS Service App” 서비스 응용 프로그램에 대해 보고서 서버 전자 메일 배달 확장 프로그램의 현재 구성 값을 반환합니다. 첫 번째 단계에서는 $app 변수 값을 "My RS Service App" 이름을 가진 서비스 응용 프로그램의 개체로 설정합니다.

두 번째 문은 $app 변수에서 서비스 응용 프로그램 개체에 대한 'Report Server Email' 배달 확장 프로그램을 가져오고 configurationXML을 선택합니다.

$app=get-sprsserviceapplication –Name "My RS Service App"
Get-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml

Top

보고 서비스 응용 프로그램 데이터베이스의 속성 가져오기 및 설정

다음 예에서는 set 명령에 적용되는 데이터베이스 guid(ID)를 결정할 수 있도록 데이터베이스 및 속성의 목록을 먼저 반환합니다. 전체 속성 목록을 보려면 Get-SPRSDatabase | format-list를 사용하세요.

get-SPRSDatabase | select id, querytimeout,connectiontimeout, status, server, ServiceInstance 

출력의 예는 다음과 같습니다. SET cmdlet에서 ID를 수정 및 사용하려는 데이터베이스에 대한 ID를 확인합니다.

• Id : 56f8d1bc-cb04-44cf-bd41-a873643c5a14

  QueryTimeout : 120

  ConnectionTimeout : 15

  Status : Online

  Server : SPServer Name=uetestb01

  ServiceInstance : SPDatabaseServiceInstance

Set-SPRSDatabase –identity 56f8d1bc-cb04-44cf-bd41-a873643c5a14 -QueryTimeout 300

값이 설정되었는지 확인하려면 GET cmdlet을 다시 실행합니다.

Get-SPRSDatabase –identity 56f8d1bc-cb04-44cf-bd41-a873643c5a14 | select id, querytimeout,connectiontimeout, status, server, ServiceInstance

Top

데이터 확장 나열

다음 예에서는 각 Reporting Services 서비스 응용 프로그램을 반복하고 각각에 대한 현재 데이터 확장을 나열합니다.

$apps = Get-SPRSServiceApplication
foreach ($app in $apps) 
{
Write-host -ForegroundColor "yellow" Service App Name $app.Name
Get-SPRSExtension -identity $app -ExtensionType “Data” | select name,extensiontype | Format-Table -AutoSize
}

예제 출력:

• Name ExtensionType

  ---- -------------

  SQL Data

  SQLAZURE Data

  SQLPDW Data

  OLEDB Data

  OLEDB-MD Data

  ORACLE Data

  ODBC Data

  XML Data

  SHAREPOINTLIST Data

Top

구독 소유자 변경 및 나열

Use PowerShell to Change and List Reporting Services Subscription Owners and Run a Subscription를 참조하세요.

Top

참고 항목

개념

Use PowerShell to Change and List Reporting Services Subscription Owners and Run a Subscription

SQL Server PowerShell 도움말 보기

관련 자료

CodePlex SharePoint 관리 PowerShell 스크립트

PowerShell을 사용하여 SSRS를 관리하는 방법