다음을 통해 공유


Install-SPFeature

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

Syntax

Install-SPFeature
       [-Path] <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-CompatibilityLevel <Int32>]
       [-Confirm]
       [-Force]
       [-WhatIf]
       [<CommonParameters>]
Install-SPFeature
       [-AllExistingFeatures]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-SolutionId <String>]
       [-WhatIf]
       [<CommonParameters>]
Install-SPFeature
       [-ScanForFeatures]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-SolutionId <String>]
       [-WhatIf]
       [<CommonParameters>]

Description

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

Install-SPFeature cmdlet은 버전별 공통 FEATURES 폴더에서 기능으로의 상대 경로를 Identity 매개 변수에 제공하여 특정 SPFeature를 설치합니다. 사이트 모음이 14 모드인 경우 버전별 FEATURES 폴더는 "$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 폴더에 있는 모든 새 기능이 설치됩니다. 일반적으로 배포 및 업그레이드 중에만 사용됩니다.

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

예제

---------------예제 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\14\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에 새 기능을 설치합니다.

매개 변수

-AllExistingFeatures

등록되지 않은 기존 기능을 검색한 다음 팜에 등록합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CompatibilityLevel

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

이 값은 14 또는 15일 수 있습니다.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Force

이미 설치된 기능을 강제로 설치합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Path

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

기능 경로는 14\Template\Features 디렉터리의 리터럴 경로여야 합니다. feature.xml 파일 이름은 암시적으로 지정되므로 제공하지 않아도 됩니다.

기능 경로를 찾을 수 없으면 "위치 14\Template\Features\<file 경로>에서 XML 파일을 찾지 못했습니다."라는 오류 메시지가 표시됩니다.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ScanForFeatures

기능을 검색한 다음 표시합니다. ScanForFeatures 매개 변수는 기능을 설치하지 않습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SolutionId

기능의 솔루션 ID를 지정합니다. SolutionId 매개 변수를 제공하지 않으면 모든 솔루션 ID를 검색합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019