Install-SPSolution
적용 대상:
설치된 SharePoint 솔루션을 팜에 배포합니다.
Install-SPSolution [-Identity] <SPSolutionPipeBind> [-AllWebApplications <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>] [-CASPolicies <SwitchParameter>] [-CompatibilityLevel <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-FullTrustBinDeployment <SwitchParameter>] [-GACDeployment <SwitchParameter>] [-Language <UInt32>] [-Local <SwitchParameter>] [-Time <String>] [-WebApplication <SPWebApplicationPipeBind>] [-WhatIf [<SwitchParameter>]]
Install-SPSolution [[-Identity] <SPSolutionPipeBind>] -Synchronize <SwitchParameter> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Language <UInt32>] [-WhatIf [<SwitchParameter>]]
매개 변수
1| 매개 변수 | 필수 | 형식 | 설명 | ||
| Identity | 필수 | Microsoft.SharePoint.PowerShell.SPSolutionPipeBind | 배포할 SharePoint 솔루션을 지정합니다. 값은 12345678-90ab-cdef-1234-567890bcdefgh 형식의 인증 GUID, SharePoint 솔루션의 인증 이름(예: SPSolution1) 또는 인증 SPSolution 개체의 인스턴스여야 합니다. | ||
| AllWebApplications | 선택 | System.Management.Automation.SwitchParameter | 팜에서 모든 SharePoint Web 응용 프로그램에 대해 새 SharePoint 솔루션을 배포하도록 지정합니다. | ||
| AssignmentCollection | 선택 | Microsoft.SharePoint.PowerShell.SPAssignmentCollection | 올바른 삭제를 위해 개체를 관리합니다. SPWeb 또는 SPSite와 같은 개체를 사용하는 경우 많은 양의 메모리를 사용할 수 있으며, Windows PowerShell 스크립트에서 이러한 개체를 사용하려면 올바른 메모리 관리가 필요합니다. SPAssignment 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다.
| ||
| CASPolicies | 선택 | System.Management.Automation.SwitchParameter | 새 SharePoint 솔루션에 대해 CAS(코드 액세스 보안) 정책을 배포할 수 있도록 지정합니다. | ||
| CompatibilityLevel | 선택 | System.String | CompatibilityLevel을 기준으로 특정 버전 디렉터리에 솔루션을 설치할지 여부를 지정합니다. 이 매개 변수를 지정하지 않는 경우의 기본 동작은 솔루션 cab 파일의 매니페스트에서 추적된 버전에 기반으로 하는 버전 디렉터리에만 솔루션을 설치하는 것입니다. | ||
| Confirm | 선택 | System.Management.Automation.SwitchParameter | 명령을 실행하기 전에 확인 메시지가 표시됩니다. 자세한 내용을 보려면 get-help about_commonparameters 명령을 입력하십시오. | ||
| Force | 선택 | System.Management.Automation.SwitchParameter | 새 SharePoint 솔루션을 강제로 배포합니다. | ||
| FullTrustBinDeployment | 선택 | System.Management.Automation.SwitchParameter | 완전 신뢰 Bin 배포를 허용하도록 지정합니다. 솔루션을 완전히 신뢰하는 경우 이 매개 변수를 사용합니다. Bin 어셈블리는 가상 서버의 bin 디렉터리에 설치되는 어셈블리입니다. 패키지의 어셈블리에는 DeploymentTarget=WebApplication 특성이 설정됩니다. bin 어셈블리에 대한 자세한 내용은 어셈블리 요소를 참조하십시오. | ||
| GACDeployment | 선택 | System.Management.Automation.SwitchParameter | 새 SharePoint 솔루션에 대해 GAC(전역 어셈블리 캐시)를 배포할 수 있도록 지정합니다. | ||
| Language | 선택 | System.UInt32 | 솔루션 언어 패키지를 배포할 때 솔루션의 언어를 지정합니다. 이 매개 변수를 지정하지 않으면 영("0")으로 가정합니다. 영("0")은 모든 언어에 유효한 솔루션에 사용됩니다. | ||
| Local | 선택 | System.Management.Automation.SwitchParameter | 활성 서버에 솔루션을 배포합니다. | ||
| Time | 선택 | System.String | 솔루션이 배포되는 시기를 지정합니다. 기본값은 즉시 배포입니다. 형식은 2010, 5, 1 형식의 유효한 DateTime 값이어야 합니다. | ||
| WebApplication | 선택 | Microsoft.SharePoint.PowerShell.SPWebApplicationPipeBind | 지정한 SharePoint 웹 응용 프로그램에 대한 SharePoint 솔루션을 배포합니다. 값은 다음 형식 중 하나여야 합니다.
| ||
| WhatIf | 선택 | System.Management.Automation.SwitchParameter | 명령을 실행하는 대신에 명령의 효과를 설명하는 메시지를 표시합니다. 자세한 내용을 보려면 get-help about_commonparameters 명령을 입력하십시오. |
| 매개 변수 | 필수 | 형식 | 설명 | ||
| Identity | 필수 | Microsoft.SharePoint.PowerShell.SPSolutionPipeBind | 배포할 SharePoint 솔루션을 지정합니다. 값은 12345678-90ab-cdef-1234-567890bcdefgh 형식의 인증 GUID, SharePoint 솔루션의 인증 이름(예: SPSolution1) 또는 인증 SPSolution 개체의 인스턴스여야 합니다. | ||
| AssignmentCollection | 선택 | Microsoft.SharePoint.PowerShell.SPAssignmentCollection | 올바른 삭제를 위해 개체를 관리합니다. SPWeb 또는 SPSite와 같은 개체를 사용하는 경우 많은 양의 메모리를 사용할 수 있으며, Windows PowerShell 스크립트에서 이러한 개체를 사용하려면 올바른 메모리 관리가 필요합니다. SPAssignment 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다.
| ||
| Confirm | 선택 | System.Management.Automation.SwitchParameter | 명령을 실행하기 전에 확인 메시지가 표시됩니다. 자세한 내용을 보려면 get-help about_commonparameters 명령을 입력하십시오. | ||
| Language | 선택 | System.UInt32 | 솔루션 언어 패키지를 배포할 때 솔루션의 언어를 지정합니다. 이 매개 변수를 지정하지 않으면 영("0")으로 가정합니다. 영("0")은 모든 언어에 유효한 솔루션에 사용됩니다. | ||
| Synchronize | 선택 | System.Management.Automation.SwitchParameter | 로컬 팜에서 모든 솔루션 또는 지정된 솔루션을 동기화합니다. | ||
| WhatIf | 선택 | System.Management.Automation.SwitchParameter | 명령을 실행하는 대신에 명령의 효과를 설명하는 메시지를 표시합니다. 자세한 내용을 보려면 get-help about_commonparameters 명령을 입력하십시오. |
자세한 설명
이 cmdlet에는 둘 이상의 매개 변수 집합이 포함됩니다. 한 매개 변수 집합의 매개 변수만 사용할 수 있으며 서로 다른 매개 변수 집합의 매개 변수를 결합하면 안 됩니다. 매개 변수 집합 사용 방법에 대한 자세한 내용은 Cmdlet 매개 변수 집합을 참조하십시오.
Install-SPSolution cmdlet은 설치된 SharePoint 솔루션을 팜에 배포합니다. Add-SPSolution cmdlet을 사용하여 팜에 SharePoint 솔루션 패키지를 설치합니다.
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
| 예외 | 설명 |
|---|---|
------------------예제 1------------------
Install-SPSolution -Identity contoso_solution.wsp -GACDeployment
이 예제에서는 팜에 설치된 SharePoint 솔루션 contoso_solution.wsp를 배포하고 새 SharePoint 솔루션에 대해 GAC를 배포할 수 있도록 지정합니다.
------------------예제 2------------------
Install-SPSolution -Identity contoso_solution.wsp -GACDeployment --CompatibilityLevel 15
이 예제에서는 팜의 최신 버전 디렉터리 내에 설치된 SharePoint 솔루션 contoso_solution.wsp를 배포하고 새 SharePoint 솔루션에 대해 GAC(전역 어셈블리 캐시)를 배포할 수 있도록 지정합니다.
------------------예제 3------------------
Install-SPSolution -Identity contoso_solution.wsp -GACDeployment -CompatibilityLevel {14,15}
이 예제에서는 14 및 15 모드 사이트 모음에서 모두 정상적으로 사용할 수 있도록 설치된 SharePoint 솔루션을 배포하고 이전에 추가한 솔루션을 설치합니다.

참고: