Install-SPFeature

아티클
10/14/2016

적용 대상: SharePoint Foundation 2010, SharePoint Server 2010

마지막으로 수정된 항목: 2015-03-09

Feature.xml 파일을 사용하여 SharePoint 기능을 설치합니다.

Syntax

Install-SPFeature [-Path] <String> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Install-SPFeature -AllExistingFeatures <SwitchParameter> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-SolutionId <String>] [-WhatIf [<SwitchParameter>]]

Install-SPFeature -ScanForFeatures <SwitchParameter> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-SolutionId <String>] [-WhatIf [<SwitchParameter>]]

자세한 설명

Install-SPFeature cmdlet은 "$env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES\" 폴더에서 기능으로의 상대 경로를 Identity 매개 변수에 제공하여 특정 SPFeature 개체를 설치합니다. SharePoint 기능 파일이 수동으로 또는 솔루션 설치 관리자를 통해 적절한 디렉터리에 이미 배치되어 있어야 합니다.

AllExistingFeatures 매개 변수를 제공하면 파일 시스템이 검색되고 새 기능이 모두 설치됩니다. 일반적으로 배포 및 업그레이드 중에만 사용됩니다.

Parameters

매개 변수	필수	형식	설명
Path	필수	System.String	유효한 파일 경로(예: MyFeature)를 지정합니다. 기능 경로는 14\Template\Features 디렉터리의 리터럴 경로여야 합니다. 이 경로에는 Windows 시스템에서 파일 이름에 대해 지원하는 모든 표준 문자를 사용할 수 있습니다. feature.xml 파일 이름은 암시적으로 사용되며 제공하지 않아도 됩니다. 디스크에 기능 파일이 없으면 "14\Template\Features\<파일 경로> 위치에서 XML 파일을 찾지 못했습니다."라는 오류 메시지가 표시됩니다.
AllExistingFeatures	필수	System.Management.Automation.SwitchParameter	등록되지 않은 기존 기능을 검색한 다음 팜에 등록합니다.
ScanForFeatures	필수	System.Management.Automation.SwitchParameter	기능을 검색한 다음 표시합니다. ScanForFeatures 매개 변수는 기능을 설치하지 않습니다.
AssignmentCollection	선택	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	올바른 삭제를 위해 개체를 관리합니다. SPWeb 또는 SPSite와 같은 개체를 사용하는 경우 많은 양의 메모리를 사용할 수 있으며, Windows PowerShell 스크립트에서 이러한 개체를 사용하려면 올바른 메모리 관리가 필요합니다. SPAssignment 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다. Note Global 매개 변수가 사용되는 경우 모든 개체가 전역 저장소에 포함됩니다. 개체가 즉시 사용되지 않거나 Stop-SPAssignment 명령을 사용하여 삭제되지 않는 경우 메모리 부족 시나리오가 발생할 수 있습니다.
Confirm	선택	System.Management.Automation.SwitchParameter	명령을 실행하기 전에 확인 메시지가 표시됩니다. 자세한 내용을 보려면 get-help about_commonparameters 명령을 입력하십시오.
Force	선택	System.Management.Automation.SwitchParameter	이미 설치된 기능을 강제로 설치합니다.
SolutionId	선택	System.String	기능의 솔루션 ID를 지정합니다. SolutionId 매개 변수를 제공하지 않으면 모든 솔루션 ID를 검색합니다.
WhatIf	선택	System.Management.Automation.SwitchParameter	명령을 실행하는 대신에 명령의 효과를 설명하는 메시지를 표시합니다. 자세한 내용을 보려면 get-help about_commonparameters 명령을 입력하십시오.

입력 형식

반환 형식

Example

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

Install-SPFeature -path "MyCustomFeature"

이 예제에서는 $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES\MyCustomFeature/feature.xml에 새 기능을 설치합니다.

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

Install-SPFeature -AllExistingFeatures -Whatif

이 예제에서는 파일 시스템에서 사용 가능한 등록되지 않은 기능을 보여 줍니다. 이러한 기능은 WhatIf 매개 변수 없이 이 명령을 실행할 경우 설치됩니다. 일반적으로 이 작업은 업그레이드 후에 실행됩니다.

다음을 통해 공유