Install-SPSolution

참조

모듈:: sharepoint-server

적용 대상:: SharePoint Server Subscription Edition

설치된 SharePoint 솔루션을 팜에 배포합니다.

Syntax

Install-SPSolution
       [-Identity] <SPSolutionPipeBind>
       [-AllWebApplications]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-CASPolicies]
       [-CompatibilityLevel <String>]
       [-Confirm]
       [-Force]
       [-FullTrustBinDeployment]
       [-GACDeployment]
       [-Language <UInt32>]
       [-Local]
       [-Time <String>]
       [-WebApplication <SPWebApplicationPipeBind>]
       [-WhatIf]
       [<CommonParameters>]

Install-SPSolution
       [[-Identity] <SPSolutionPipeBind>]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Language <UInt32>]
       [-Synchronize]
       [-WhatIf]
       [<CommonParameters>]

Description

이 cmdlet에는 둘 이상의 매개 변수 집합이 포함됩니다. 한 매개 변수 집합의 매개 변수만 사용할 수 있으며 서로 다른 매개 변수 집합의 매개 변수를 결합하면 안 됩니다. 매개 변수 집합을 사용하는 방법에 대한 자세한 내용은 Cmdlet 매개 변수 집합(https://learn.microsoft.com/powershell/scripting/developer/cmdlet/cmdlet-parameter-sets?view=powershell-5.1)을 참조하세요.

Install-SPSolution cmdlet은 설치된 SharePoint 솔루션을 팜에 배포합니다. Add-SPSolution cmdlet을 사용하여 팜에 SharePoint 솔루션 패키지를 설치합니다.

SharePoint 제품용 Windows PowerShell에 대한 사용 권한 및 최신 정보는 SharePoint Server Cmdlets를 참조하세요.

예제

------------------예제 1------------------

Install-SPSolution -Identity contoso_solution.wsp -GACDeployment

이 예제에서는 팜에 설치된 SharePoint 솔루션 contoso_solution.wsp를 배포하고 새 SharePoint 솔루션에 대해 GAC를 배포할 수 있도록 지정합니다.

------------------예제 2------------------

Install-SPSolution -Identity contoso_solution.wsp -GACDeployment -CompatibilityLevel {14,15}

이 예제에서는 14 및 15 모드 사이트 모음에서 모두 정상적으로 사용할 수 있도록 설치된 SharePoint 솔루션을 배포하고 이전에 추가한 솔루션을 설치합니다.

매개 변수

-AllWebApplications

팜에서 모든 SharePoint Web 응용 프로그램에 대해 새 SharePoint 솔루션을 배포하도록 지정합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AssignmentCollection

올바른 삭제를 위해 개체를 관리합니다. SPWeb 또는 SPSite와 같은 개체를 사용하는 경우 많은 양의 메모리를 사용할 수 있으며, Windows PowerShell 스크립트에서 이러한 개체를 사용하려면 올바른 메모리 관리가 필요합니다. SPAssignment 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다.

Global 매개 변수가 사용되는 경우 모든 개체가 전역 저장소에 포함됩니다. 개체가 즉시 사용되지 않거나 Stop-SPAssignment 명령을 사용하여 삭제되지 않는 경우 메모리 부족 시나리오가 발생할 수 있습니다.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-CASPolicies

새 SharePoint 솔루션에 대해 CAS(코드 액세스 보안) 정책을 배포할 수 있도록 지정합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-CompatibilityLevel

CompatibilityLevel을 기준으로 특정 버전 디렉터리에 솔루션을 설치할지 여부를 지정합니다. 이 매개 변수를 지정하지 않는 경우의 기본 동작은 솔루션 cab 파일의 매니페스트에서 추적된 버전에 기반으로 하는 버전 디렉터리에만 솔루션을 설치하는 것입니다.

유효한 값은 다음과 같습니다.

--14

--15

--14,15

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Confirm

명령을 실행하기 전에 사용자에게 확인 메시지를 표시합니다. 자세한 내용을 확인하려면 다음 명령을 입력하세요. get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Force

새 SharePoint 솔루션을 강제로 배포합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-FullTrustBinDeployment

완전 신뢰 Bin 배포를 허용하도록 지정합니다. 솔루션을 완전히 신뢰하는 경우 이 매개 변수를 사용합니다.

Bin 어셈블리는 가상 서버의 Bin 디렉터리에 설치되는 어셈블리입니다. 패키지의 어셈블리에는 DeploymentTarget=WebApplication 특성이 설정됩니다. Bin 어셈블리에 대한 자세한 내용은 어셈블리 요소를 참조하세요.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-GACDeployment

새 SharePoint 솔루션에 대해 GAC(전역 어셈블리 캐시)를 배포할 수 있도록 지정합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Identity

배포할 SharePoint 솔루션을 지정합니다.

값은 12345678-90ab-cdef-1234-567890bcdefgh 형식의 인증 GUID, SharePoint 솔루션의 인증 이름(예: SPSolution1) 또는 인증 SPSolution 개체의 인스턴스여야 합니다.

Type:	SPSolutionPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Language

솔루션 언어 패키지를 배포할 때 솔루션의 언어를 지정합니다. 이 매개 변수를 지정하지 않으면 영("0")으로 가정합니다. 영("0")은 모든 언어에 유효한 솔루션에 사용됩니다.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Local

활성 서버에 솔루션을 배포합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Synchronize

로컬 팜에서 모든 솔루션 또는 지정된 솔루션을 동기화합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Time

솔루션이 배포되는 시기를 지정합니다. 기본값은 즉시 배포입니다.

형식은 2010, 5, 1 형식의 유효한 DateTime 값이어야 합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WebApplication

지정한 SharePoint 웹 응용 프로그램에 대한 SharePoint 솔루션을 배포합니다.

값은 다음 형식 중 하나여야 합니다.

--12345678-90ab-cdef-1234-567890bcdefgh 형식의 정통 GUID

--SharePoint 웹 애플리케이션의 정품 이름(예: MyOfficeApp1)

--authentic SPWebApplication 개체의 인스턴스입니다.

Type:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WhatIf

명령을 실행하는 대신에 명령의 효과를 설명하는 메시지를 표시합니다. 자세한 내용을 확인하려면 다음 명령을 입력하세요. get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition