내보내기(0) 인쇄
모두 확장

Install-SPFeature

 

적용 대상: SharePoint Server 2013 Enterprise, SharePoint Foundation 2013

마지막으로 수정된 항목: 2013-12-18

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

Install-SPFeature [-Path] <String> [-AssignmentCollection <SPAssignmentCollection>] [-CompatibilityLevel <Int32>] [-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>]]

이 cmdlet에는 둘 이상의 매개 변수 집합이 포함됩니다. 한 매개 변수 집합의 매개 변수만 사용할 수 있으며 서로 다른 매개 변수 집합의 매개 변수를 결합하면 안 됩니다. 매개 변수 집합 사용 방법에 대한 자세한 내용은 Cmdlet 매개 변수 집합을 참조하십시오.

Install-SPFeature cmdlet은 버전별 공통 FEATURES 폴더에서 기능으로의 상대 경로를 Identity 매개 변수에 제공하여 특정 SPFeature를 설치합니다. 버전별 FEATURE 폴더는 사이트 모음이 14 모드인 경우 “$env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES\”이고, 사이트 모음이 15 모드인 경우에는 “$env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES\”입니다. SharePoint 기능의 파일은 솔루션 설치 관리자를 사용하여 또는 수동으로 적절한 디렉터리에 이미 배치한 상태여야 합니다.

AllExistingFeatures 매개 변수의 값이 true이면 파일 시스템이 검색되고 두 FEATURES 폴더에 있는 모든 새 기능이 설치됩니다. 일반적으로 배포 및 업그레이드 중에만 사용됩니다.

 

매개 변수 필수 형식 설명

Path

필수

System.String

인증 파일 경로(예: MyFeature)를 지정합니다.

기능 경로는 14\Template\Features 디렉터리의 리터럴 경로여야 합니다. 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 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다.

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

CompatibilityLevel

선택

System.Int32

설치할 기능의 버전을 지정합니다. 버전을 지정하지 않으면 기본적으로 웹 응용 프로그램 MaxVersion 값이 사용됩니다.

이 매개 변수의 값은 SharePoint Server 2010 또는 SharePoint Server 2013일 수 있습니다.

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 명령을 입력하십시오.

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

Install-SPFeature -path "MyCustomFeature"

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

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

Install-SPFeature -AllExistingFeatures -Whatif

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

---------------예제 3---------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 14

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

---------------예제 4---------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 15

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

이 정보가 도움이 되었습니까?
(1500자 남음)
의견을 주셔서 감사합니다.
표시:
© 2014 Microsoft