PowerShell 구성 스크립트(PowerPivot for SharePoint)
이 항목은 PowerShell 스크립트를 통해 서버를 배포하거나 유지 관리하는 서비스 관리자 또는 SharePoint 팜용입니다. SharePoint 2010 중앙 관리를 사용하여 이와 같은 태스크를 수행하는 방법은 구성(PowerPivot for SharePoint)을 참조하십시오.
이미 구성되어 있거나 팜의 멤버인 기존 SharePoint 서버에 SQL Server PowerPivot for SharePoint를 설치한 경우 SQL Server 설치 프로그램은 PowerPivot for SharePoint 배포에 사용할 수 있도록 SharePoint 서비스 또는 응용 프로그램을 만들거나 수정하지 않습니다. 배포를 완료하려면 구성 태스크를 직접 수행해야 합니다. 모든 설치 후 태스크는 스크립트를 통해 수행할 수 있습니다. 이 항목에서는 스크립트 사용 및 실행을 위한 지침과 템플릿을 제공합니다.
이 항목에는 다음과 같은 섹션이 있습니다.
사전 요구 사항
명령 실행 방법
PowerPivot 솔루션 배포
PowerPivot 기능 활성화
PowerPivot 서비스 응용 프로그램 만들기
Windows 토큰 서비스에 대한 클레임 시작
Excel 서비스 설정 및 구성
Secure Store Service 설정 및 데이터 새로 고침 구성
웹 응용 프로그램의 최대 업로드 크기 늘리기
사전 요구 사항
이 항목의 명령을 실행하려면 로컬 관리자 및 팜 관리자여야 합니다.
명령 실행 방법
이 항목의 PowerShell 명령은 PowerPivot for SharePoint 배포의 특정 측면 구성에 대한 섹션으로 정렬되어 있습니다. SharePoint 2010 관리 셸에서 각 명령 블록을 개별적으로 실행하거나 .ps1 파일에 이들 명령 블록을 포함할 수 있습니다.
각 명령을 개별적으로 실행하려면
Microsoft SharePoint 2010 제품 프로그램 그룹에서 SharePoint 2010 관리 셸을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행을 선택합니다.
셸에 다음 명령을 입력하여 해당 권한이 있는지 확인합니다. 명령을 실행하면 Excel 서비스에서 지원하는 PowerShell 명령 목록이 반환됩니다.
get-help *SPExcel*
.ps1 파일을 실행하려면
단일 .ps1 파일에 스크립트를 결합하여 단일 작업으로 모든 설정을 구성할 수도 있습니다. 이렇게 하는 경우에는 서명되지 않은 스크립트를 실행하기 위해 실행 정책을 일시적으로 변경해야 합니다. 다음 단계에서는 이 작업을 수행하는 방법에 대해 설명합니다.
관리자 권한으로 SharePoint 2010 관리 콘솔을 엽니다.
다음 명령을 실행하여 실행 정책을 결정합니다. 나중에 PowerPivot for SharePoint 배포가 완료되면 실행 정책을 이 값으로 다시 설정합니다.
Get-ExecutionPolicy다음 명령을 실행하여 서명되지 않은 스크립트를 실행할 수 있도록 실행 정책을 일시적으로 변경합니다. Y 키를 입력하여 동작을 확인합니다.
Set-ExecutionPolicy Unrestricted정규화된 파일 이름을 입력하여 스크립트를 실행합니다. 예를 들어 스크립트를 PowerPivotConfig.ps1이라는 파일에 저장한 경우에는 다음 줄을 입력하고 Enter 키를 눌러 스크립트를 실행합니다.
C:\Scripts-ps1\PowerPivotConfig.ps1실행 정책을 2단계에서 확인한 원래 값으로 다시 설정합니다. Y 키를 입력하여 동작을 확인합니다.
Set-ExecutionPolicy restricted
PowerShell 창에서 값을 복사하려면
이 항목 중 일부 절차에서는 PowerShell 창에서 ID를 복사할 것을 요청합니다. 이에 대한 방법을 모르는 경우에는 다음 지침을 사용합니다.
관리자 권한으로 SharePoint 2010 관리 콘솔을 엽니다.
GUID를 반환하는 명령을 입력합니다(예: Get-SPServiceInstance).
창의 왼쪽 위 모퉁이에 있는 PowerShell 아이콘을 클릭합니다.
편집을 가리킨 다음 표시를 클릭합니다.
커서를 사용하여 ID를 강조 표시합니다.
PowerShell 아이콘을 다시 클릭하고 편집을 가리킨 다음 복사를 클릭합니다. 이제 ID가 클립보드에 저장되었습니다. 매개 변수 값으로 ID를 사용하는 다른 명령 문에 이 값을 붙여 넣을 수 있습니다.
PowerPivot 솔루션 배포
PowerPivot for SharePoint에는 PowerPivot 서비스 응용 프로그램을 만들기 전에 배포해야 하는 전역 솔루션과 응용 프로그램 수준 솔루션이 하나씩 포함되어 있습니다. 전역 솔루션은 SQL Server 설치 프로그램을 통해 배포됩니다. 응용 프로그램 수준 솔루션은 설치 후에 배포해야 합니다. PowerPivot 기능 통합을 지원할 각 SharePoint 웹 응용 프로그램에 대해 이 스크립트를 실행해야 합니다.
이 스크립트 대신 다음 항목의 지침을 사용할 수도 있습니다. PowerPivot 솔루션 배포.
Install-SPSolution -Identity PowerPivotWebApp.wsp -AllWebApplications -GACDeployment
기능 활성화
각 사이트 모음에 대해 PowerPivot 기능을 활성화해야 합니다. 이 스크립트는 "somesite"라는 이름으로 SharePoint 웹 응용 프로그램의 루트 사이트 모음을 지정합니다. 여기서 "somesite"를 사용하는 웹 응용 프로그램의 실제 이름으로 바꾸십시오. 가령 추가 사이트 모음(예: 사이트의 이름은 PowerPivot임)을 만든 경우 URL은 http://somesite/PowerPivot이 됩니다.
이 스크립트 대신 다음 항목의 지침을 사용할 수도 있습니다. 사이트 모음에 대해 PowerPivot 기능 통합 활성화.
Enable-SPFeature -Identity "PowerPivotSite" -URL http://somesite/
[!참고]
Get-SPFeature 명령을 사용하여 모든 팜, 웹 및 사이트 범위의 기능에 대한 목록을 볼 수 있습니다. 이 명령을 실행하면 PowerPivot 팜 기능 및 PowerPivot 사이트 모음 기능 모두에 대한 이름 및 ID가 표시됩니다.
PowerPivot 서비스 응용 프로그램 만들기
PowerPivot 서비스 응용 프로그램을 만들면 PowerPivot 시스템 서비스에 대한 HTTP 끝점이 제공됩니다. 팜에 PowerPivot 서비스 응용 프로그램이 하나 이상 있어야 하며 해당 프로그램은 기본 프록시 그룹의 멤버여야 합니다.
이 스크립트는 기본 서비스 응용 프로그램 풀을 PowerPivot 서비스 응용 프로그램의 서비스 ID로 사용합니다. 또한 이 스크립트에는 팜 데이터베이스 서버에 대한 자리 표시자가 포함되어 있습니다. 따라서 'Your database server name goes here' 문자열을 팜의 구성 데이터베이스를 호스팅하는 SQL Server 데이터베이스 엔진 인스턴스 이름으로 바꿔야 합니다.
스크립트를 실행하기 전에 데이터베이스 서버가 원격 TCP/IP 연결을 허용하도록 구성되어 있는지 확인하십시오. 아직 구성하지 않았다면 SQL Server 구성 도구를 사용하여 TCP/IP를 사용하도록 설정할 수 있습니다.
이 스크립트 대신 다음 항목의 지침을 사용할 수도 있습니다. PowerPivot 서비스 응용 프로그램 만들기 및 구성.
New-PowerPivotServiceApplication -ServiceApplicationName "Default PowerPivot Service Application" -DatabaseServerName "your database server name goes here" -DatabaseName DefaultPowerPivotServiceApplicationDB -AddToDefaultProxyGroup
Windows 토큰 서비스에 대한 클레임 시작
Windows 토큰 서비스에 대한 클레임은 PowerPivot for SharePoint가 설치되어 있는 각 SharePoint 서버에서 실행해야 합니다.
이 스크립트 대신 다음 항목의 지침을 사용할 수도 있습니다. 기존 SharePoint 서버에 PowerPivot for SharePoint 설치.
다음 명령을 실행하여 Windows 토큰 서비스에 대한 클레임의 ID를 가져옵니다.
Get-SPServiceInstance서비스에 대해 반환되는 ID를 복사합니다.
서비스를 지정하는 ID를 사용하여 다음 명령을 입력합니다.
Start-SPServiceInstance <ID>Get-SPServiceInstance를 다시 실행하여 Windows 토큰 서비스에 대한 클레임이 온라인 상태인지 확인합니다.
PowerPivot for SharePoint가 설치되어 있는 각 SharePoint 서버에 대해 반복합니다.
Excel 서비스 설정 및 구성
Excel 서비스는 SharePoint에 게시하는 Excel 통합 문서의 서버측 렌더링을 수행합니다. PowerPivot for SharePoint는 Excel 서비스를 사용하여 PowerPivot 데이터에 대한 요청을 트리거하고 PowerPivot 데이터를 피벗 테이블 또는 워크시트의 기타 데이터 개체로 렌더링합니다.
이 스크립트 대신 다음 항목의 지침을 사용할 수도 있습니다. 기존 SharePoint 서버에 PowerPivot for SharePoint 설치.
정보를 수집하여 사전 요구 사항 확인
다음 명령을 실행하여 Excel 계산 서비스가 온라인 상태인지 확인합니다. 온라인 상태가 아니면 Windows 토큰 서비스에 대한 클레임을 시작할 때 사용한 방법과 같은 방법을 사용하여 서비스를 시작합니다.
Get-SPServiceInstance다음 명령을 실행하여 Excel Services 응용 프로그램이 이미 설정되어 있는지 확인합니다. 서비스 응용 프로그램이 이미 있는 경우 해당 서비스를 생성하는 명령을 건너뛰고 대신 외부 데이터 액세스를 사용하도록 설정하는 명령을 실행하고 최대 통합 문서 크기를 늘리고 데이터 새로 고침 경고를 해제합니다.
Get-SPExcelServiceApplication서비스 응용 프로그램을 만들기 위해 사용할 응용 프로그램 풀의 이름을 가져옵니다. 뒤에 나오는 스크립트에서는 SharePoint 웹 서비스 기본 응용 프로그램 풀을 사용합니다. 그러나 다음 명령을 실행하여 다른 응용 프로그램 풀이 더 적절한지 확인할 수 있습니다.
Get-SPServiceApplicationPool
서비스 응용 프로그램 및 서비스 응용 프로그램 프록시 만들기
New-SPExcelServiceApplication -name "Excel Services Application" –ApplicationPool "SharePoint Web Services Default"
New-SPExcelServiceApplicationProxy -name "Excel Services Application Proxy" –ServiceApplication "Excel Services Application" -DefaultProxyGroup
서비스 응용 프로그램 구성
이 스크립트는 최대 통합 문서 크기를 늘리고 외부 데이터 액세스를 설정한 다음 데이터 새로 고침 경고를 해제합니다.
Set-SPExcelFileLocation -Identity 'http://' -ExcelServiceApplication "Excel Services Application" -ExternalDataAllowed 2 -WorkbookSizeMax 2000 -WarnOnDataRefresh:$false
서비스 응용 프로그램을 기본 서비스 응용 프로그램 프록시 그룹에 추가
Excel 서비스 응용 프로그램에 대한 서비스 응용 프로그램 프록시 ID를 가져온 다음 해당 ID를 복사합니다.
Get-SPServiceApplicationProxy기본 프록시 그룹에 서비스 응용 프로그램 프록시 ID를 추가하고 "serviceAppId"를 PowerShell 창에서 복사한 실제 ID로 바꿉니다.
$ProxyGroup = Get-SPServiceApplicationProxygroup -default Add-SPServiceApplicationProxyGroupMember -Identity $ProxyGroup -Member "serviceAppId"
Secure Store Service 설정 및 데이터 새로 고침 구성
Secure Store Service는 자격 증명을 저장하는 데 사용되는 SharePoint 리소스입니다. Secure Store Service는 PowerPivot for SharePoint에서 저장되거나 참조되는 자격 증명을 기반으로 하는 데이터 새로 고침 작업을 지원하는 데 사용됩니다.
.gif "중요 정보") 중요 |
|---|
이 섹션의 명령을 실행하는 것만으로 일부 PowerPivot 데이터 새로 고침 옵션을 충분히 설정할 수 있습니다. 특히 사용자는 자신의 자격 증명을 입력하여 데이터 새로 고침 작업을 실행하거나 자격 증명을 제공하는 미리 정의된 대상 응용 프로그램의 SSS ID를 입력할 수 있습니다. 이 스크립트는 PowerPivot 무인 데이터 새로 고침 계정을 만들거나 설정하지 않습니다. 사용자가 직접 그러한 스크립트를 개발하거나 중앙 관리에서 계정을 구성할 수 있습니다. 자세한 내용은 PowerPivot 데이터 새로 고침에 대해 저장되는 자격 증명 구성 및 사용을 참조하십시오. |
정보를 수집하여 사전 요구 사항 확인
다음 명령을 실행하여 Secure Store Service가 온라인 상태인지 확인합니다. 온라인 상태가 아니면 Windows 토큰 서비스에 대한 클레임을 시작할 때 사용한 방법과 같은 방법을 사용하여 서비스를 시작합니다.
Get-SPServiceInstance
서비스 응용 프로그램 만들기
데이터베이스 서버에 대한 자리 표시자 값을 바꾸어야 합니다.
New-SPSecureStoreServiceapplication -Name "Secure Store Service" -partitionmode:$false -sharing:$false -databaseserver "Your database server" -databasename "SecureStoreServiceAppDB" -ApplicationPool "SharePoint Web Services Default" -auditingEnabled:$true -auditlogmaxsize 30
서비스 응용 프로그램 프록시를 만들고 기본 프록시 그룹에 추가
Secure Store Services에 대한 서비스 응용 프로그램 ID를 가져온 다음 해당 ID를 복사합니다.
Get-SPServiceApplication다음 명령을 실행하여 <ID>를 이전 단계에서 복사한 서비스 응용 프로그램 ID로 바꿉니다.
New-SPSecureStoreServiceApplicationProxy -name "Secure Store Service Proxy" -ServiceApplication <ID> -defaultproxygroup
마스터 키 생성
마스터 키에 대한 변수를 설정합니다.
$newPassPhrase='type a strong password here'Secure Store Services 응용 프로그램 프록시의 ID를 복사합니다. 이 ID는 다음 단계에서 사용합니다.
Get-SPServiceApplicationProxy서비스 응용 프로그램 프록시에 대한 변수를 설정합니다.
$proxy='paste the ID for the secure store service application proxy here'다음 명령을 순서대로 실행합니다.
Update-SpSecureStoreMasterKey -ServiceApplicationProxy $proxy -PassPhrase $newPassPhrase Update-SpSecureStoreApplicationServerKey -ServiceApplicationProxy $proxy -PassPhrase $newPassPhrase
사용 현황 및 상태 데이터 수집 구성
이 스크립트로 시스템이 어떻게 사용되는지에 대한 정보를 모으는 사용 현황 데이터 및 서버 상태 데이터 수집을 사용할 수 있습니다. 이 스크립트는 데이터 수집 간격을 5분으로 지정하여 데이터 수집이 기본값인 30분보다 더 자주 수행되도록 합니다. 사용 현황 데이터 수집을 사용하면 PowerPivot 관리 대시보드에서 사용되는 정보를 포함한 기본 제공 보고서에서 사용되는 정보가 제공됩니다.
이 스크립트 대신 다음 항목의 지침을 사용할 수도 있습니다. 사용 현황 데이터 수집 구성(PowerPivot for SharePoint).
Set-SPUsageService -UsageLogCutTime 5
기본 웹 응용 프로그램의 최대 업로드 크기 다시 구성
기본적으로 SharePoint에서는 최대 50MB 크기의 파일을 업로드할 수 있습니다. 이 스크립트는 SharePoint 웹 응용 프로그램의 최대 파일 업로드 크기를 SharePoint에서 지원하는 최대값인 2047MB로 변경합니다.
다음 줄을 각각 순서대로 입력합니다. 첫 번째 줄은 웹 응용 프로그램을 가져오고 두 번째 줄은 속성을 설정하며 세 번째 줄은 서버의 속성을 업데이트합니다. "somesite"의 자리 표시자 값을 웹 응용 프로그램의 실제 이름으로 바꾸십시오. Get-SPWebApplication을 사용하여 해당 팜에서 정의된 응용 프로그램의 목록을 반환할 수 있습니다.
이 스크립트 대신 다음 항목의 지침을 사용할 수도 있습니다. 최대 파일 업로드 크기 구성(PowerPivot for SharePoint).
$webapplication=Get-SPWebApplication http://somesite/
$webapplication.MaximumFileSize=2047
$webapplication.Update()