Reporting Services SharePoint 모드용 PowerShell cmdlet
적용 대상: 
SQL Server Reporting Services(2016) SharePoint ❌ Power BI Report Server
이전 버전의 SSRS(SQL Server Reporting Services)와 관련된 콘텐츠는 SQL Server Reporting Services란?을 참조하세요.
SQL Server 2016 Reporting Services SharePoint 모드를 설치하는 경우 SharePoint 모드에서 보고서 서버를 지원하기 위해 PowerShell cmdlet이 설치됩니다. cmdlet은 세 가지 범주의 기능을 포함합니다.
Reporting Services SharePoint 공유 서비스 및 프록시 설치
Reporting Services 서비스 애플리케이션과 연결된 프록시의 프로비전 및 관리
Reporting Services 기능(예: 확장 및 암호화 키) 관리
참고
SQL Server 2016 이후부터 SharePoint와의 Reporting Services 통합을 사용할 수 없습니다.
Cmdlet 요약
cmdlet을 실행하려면 SharePoint 관리 셸을 열어야 합니다. Microsoft Windows에 포함된 그래픽 사용자 인터페이스 편집기인 Windows PowerShell ISE(통합 스크립팅 환경) 를 사용할 수도 있습니다. 자세한 내용은 Windows Server에서 Windows PowerShell 시작를 사용할 수도 있습니다. 다음 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 관리를 사용할 수도 있습니다.
SharePoint 관리 셸 열기 및 cmdlet 실행
시작 단추를 선택합니다.
Microsoft SharePoint 제품 그룹을 선택합니다.
SharePoint 관리 셸을 선택합니다.
cmdlet의 명령줄 도움말을 보려면 PowerShell 명령 프롬프트에서 PowerShell 'Get-Help' 명령을 사용합니다. 예를 들면 다음과 같습니다.
Get-Help Get-SPRSServiceApplicationServers
공유 서비스 및 프록시 Cmdlet
다음 표에는 Reporting Services SharePoint 공유 서비스에 대한 PowerShell cmdlet이 나와 있습니다.
| cmdlet | 설명 |
|---|---|
| Install-SPRSService | Reporting Services 공유 서비스를 설치 및 등록하거나 제거합니다. 이 작업은 SharePoint 모드에서 SQL Server Reporting Services가 설치된 컴퓨터에서만 수행할 수 있습니다. 설치 시 다음 두 가지 작업이 수행됩니다. -팜에 Reporting Services 서비스가 설치됩니다. -현재 시스템에 Reporting Services 서비스 인스턴스가 설치됩니다. 제거 시 다음 두 가지 작업이 수행됩니다. -현재 시스템에서 Reporting Services 서비스가 제거됩니다. -팜에서 Reporting Services 서비스가 제거됩니다. 팜 내 다른 시스템에 Reporting Services 서비스가 설치되어 있거나 팜에서 아직 Reporting Services 서비스 애플리케이션이 실행되고 있는 경우 경고 메시지가 표시됩니다. |
| Install-SPRSServiceProxy | SharePoint 팜에 Reporting Services 서비스 프록시를 설치 및 등록 또는 제거합니다. |
| Get-SPRSProxyUrl | Reporting Services 서비스에 액세스하기 위한 URL을 가져옵니다. |
| Get-SPRSServiceApplicationServers | 로컬 SharePoint 팜 내 Reporting Services 공유 서비스가 설치된 모든 서버를 가져옵니다. 이 cmdlet은 Reporting Services 업그레이드 시 공유 서비스를 실행하여 업그레이드할 서버를 확인하는 데 유용합니다. |
서비스 애플리케이션 및 프록시 Cmdlet
다음 표에는 Reporting Services 서비스 애플리케이션과 관련 프록시에 대한 PowerShell cmdlet이 포함됩니다.
| Cmdlet | Description |
|---|---|
| Get-SPRSServiceApplication | 하나 이상의 Reporting Services 서비스 애플리케이션 개체를 가져옵니다. |
| New-SPRSServiceApplication | 새 Reporting Services 서비스 애플리케이션 및 연결된 데이터베이스를 만듭니다. LogonType 매개 변수: 보고서 서버에서 보고서 서버 데이터베이스에 액세스하기 위해 SSRS 애플리케이션 풀 계정을 사용할지 또는 SQL Server 로그인을 사용할지 지정합니다. 유효한 값은 다음과 같습니다. 0 Windows 인증 1 SQL Server 2 애플리케이션 풀 계정(기본값) |
| Remove-SPRSServiceApplication | 지정된 Reporting Services 서비스 애플리케이션을 삭제합니다. 이 cmdlet은 연결된 데이터베이스도 제거합니다. |
| Set-SPRSServiceApplication | 기존 Reporting Services 서비스 애플리케이션의 속성을 편집합니다. |
| New-SPRSServiceApplicationProxy | 새 Reporting Services 서비스 애플리케이션 프록시를 만듭니다. |
| Get-SPRSServiceApplicationProxy | 하나 이상의 Reporting Services 서비스 애플리케이션 프록시를 가져옵니다. |
| Dismount-SPRSDatabase | Reporting Services 서비스 애플리케이션에 대한 서비스 애플리케이션 데이터베이스를 분리합니다. |
| Remove-SPRSDatabase | Reporting Services 서비스 애플리케이션에 대한 서비스 애플리케이션 데이터베이스를 제거합니다. |
| Set-SPRSDatabase | Reporting Services 서비스 애플리케이션에 연결된 데이터베이스의 속성을 설정합니다. |
| Mount-SPRSDatabase | Reporting Services 서비스 애플리케이션에 데이터베이스를 탑재합니다. |
| New-SPRSDatabase | 지정된 Reporting Services 서비스 애플리케이션에 대해 새 서비스 애플리케이션 데이터베이스를 만듭니다. |
| Get-SPRSDatabaseCreationScript | Reporting Services 서비스 애플리케이션의 화면에 데이터베이스 생성 스크립트를 출력합니다. 그런 다음 SQL Server Management Studio에서 스크립트를 실행할 수 있습니다. |
| Get-SPRSDatabase | 하나 이상의 Reporting Services 서비스 애플리케이션 데이터베이스를 가져옵니다. 이 명령을 사용하여 서비스 애플리케이션 데이터베이스의 ID를 가져오므로, Set-SPRSDatabase cmdlet을 사용하여 속성(예: querytimeout)을 수정할 수 있습니다. 보고 서비스 애플리케이션 데이터베이스의 속성 가져오기 및 설정 문서의 예시를 참조하세요. |
| Get-SPRSDatabaseRightsScript | Reporting Services 서비스 애플리케이션의 화면에 데이터베이스 권한 스크립트를 출력합니다. 원하는 사용자 및 데이터베이스에 대한 프롬프트를 표시한 다음 사용 권한을 수정하기 위해 실행할 수 있는 Transact-SQL을 반환합니다. 그런 다음 SQL Server Management Studio에서 이 스크립트를 실행할 수 있습니다. |
| Get-SPRSDatabaseUpgradeScript | 화면에 데이터베이스 업그레이드 스크립트를 출력합니다. 이 스크립트는 Reporting Services 서비스 애플리케이션 데이터베이스를 현재 설치하는 Reporting Services의 데이터베이스 버전으로 업그레이드합니다. |
Reporting Services 사용자 지정 기능 Cmdlet
| cmdlet | 설명 |
|---|---|
| Update-SPRSEncryptionKey | 지정된 Reporting Services 서비스 애플리케이션에 대한 암호화 키를 업데이트하고 데이터를 다시 암호화합니다. |
| Restore-SPRSEncryptionKey | Reporting Services 서비스 애플리케이션에 대해 이전에 백업된 암호화 키를 복원합니다. |
| Remove-SPRSEncryptedData | 지정된 Reporting Services 서비스 애플리케이션에 대한 암호화된 데이터를 삭제합니다. |
| Backup-SPRSEncryptionKey | 지정된 Reporting Services 서비스 애플리케이션에 대한 암호화 키를 백업합니다. |
| New-SPRSExtension | Reporting Services 서비스 애플리케이션의 새 확장 프로그램을 등록합니다. |
| Set-SPRSExtension | 기존 Reporting Services 확장 프로그램의 속성을 설정합니다. |
| Remove-SPRSExtension | Reporting Services 서비스 애플리케이션에서 확장 프로그램을 삭제합니다. |
| Get-SPRSExtension | Reporting Services 서비스 애플리케이션에 대한 하나 이상의 Reporting Services 확장 프로그램을 가져옵니다. 유효한 값은 다음과 같습니다. 배달 DeliveryUI 렌더링 데이터 보안 인증 EventProcessing ReportItems 디자이너 ReportItemDesigner ReportItemConverter ReportDefinitionCustomization |
| Get-SPRSSite | "ReportingService" 기능 사용 여부에 따라 SharePoint 사이트를 가져옵니다. 기본적으로 "ReportingService" 기능이 설정되어 있는 사이트가 반환됩니다. |
기본 샘플
이름에 '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 Service 및 서비스 프록시를 설치합니다.
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"
자세한 샘플
다음 샘플 외에도, Windows PowerShell script for Steps 1–4 문서의 "Windows PowerShell 스크립트" 섹션을 참조하세요.
Reporting Services 서비스 애플리케이션 및 프록시 만들기
이 예시 스크립트는 다음 태스크를 완료합니다.
Reporting Services 서비스 애플리케이션 및 프록시를 만듭니다. 이 스크립트는 "My App Pool" 애플리케이션 풀이 이미 있는 것으로 가정합니다.
기본 프록시 그룹에 프록시 추가
포트 80 웹앱의 콘텐츠 데이터베이스에 대한 서비스 앱 액세스를 허용합니다. 이 스크립트에서는
https://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 "https://sitename"
$appPoolAccountName = $appPool.ProcessAccount.LookupName()
$webApp.GrantAccessToProcessIdentity($appPoolAccountName)
Reporting Services 배달 확장 프로그램 검토 및 업데이트
다음 PowerShell 스크립트 예시에서는 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 " ssrs_testapp *"}
다음 스크립트는 "Reporting Services 애플리케이션"이라는 서비스 애플리케이션에 대한 보고서 서버 전자 메일 배달 확장 프로그램의 현재 구성 값을 반환합니다. 첫 번째 단계에서는 변수 $app 값을 이름이 "My RS Service App"인 서비스 애플리케이션의 개체로 설정합니다.
두 번째 문은 $app 변수에서 서비스 애플리케이션 개체에 대한 'Report Server Email' 배달 확장 프로그램을 가져오고 configurationXML을 선택합니다.
$app=get-sprsserviceapplication -Name "Reporting Services Application"
Get-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml
또한 다음과 같이 앞의 두 문을 하나로 다시 쓸 수 있습니다.
get-sprsserviceapplication -Name "Reporting Services Application" | Get-SPRSExtension -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml
보고 서비스 애플리케이션 데이터베이스의 속성 가져오기 및 설정
다음 예시에서는 데이터베이스 및 속성의 목록을 먼저 반환하므로 set 명령에 제공하는 데이터베이스 GUID(ID)를 결정할 수 없습니다. 속성의 전체 목록은 Get-SPRSDatabase | format-list를 참조하세요.
get-SPRSDatabase | select id, querytimeout,connectiontimeout, status, server, ServiceInstance
다음 출력은 예시입니다. SET cmdlet에서 수정하고 사용할 데이터베이스의 ID를 확인하세요.
Id : 56f8d1bc-cb04-44cf-bd41-a873643c5a14QueryTimeout : 120ConnectionTimeout : 15Status : OnlineServer : SPServer Name=uetestb01ServiceInstance : 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
Reporting Services 데이터 확장 프로그램 나열
다음 예시는 각 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 DataSQLAZURE DataSQLPDW DataOLEDB DataOLEDB-MD DataORACLE DataODBC DataXML DataSHAREPOINTLIST Data
Reporting Services 구독 소유자 변경 및 나열
PowerShell을 사용하여 Reporting Services 구독 소유자 변경, 나열 및 구독 실행을 참조하세요.