다음을 통해 공유


Enable-SPFeature

 

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

마지막으로 수정된 항목: 2016-10-12

지정한 범위에 설치된 SharePoint 기능을 사용하도록 설정합니다.

Syntax

Enable-SPFeature [-Identity] <SPFeatureDefinitionPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-Url <String>] [-WhatIf [<SwitchParameter>]]

자세한 설명

Enable-SPFeature cmdlet은 지정한 범위에 설치된 기능을 사용하도록 설정합니다. 기능이 팜 기능이면 URL이 필요하지 않습니다. 그렇지 않은 경우 기능을 사용하도록 설정할 위치의 URL을 제공하십시오. 기능 정의를 기준으로 하여 적절한 범위에서 기능이 활성화됩니다.

PassThru 매개 변수를 제공하지 않으면 이 cmdlet은 아무 내용도 출력하지 않으며, 이 경우 사용하도록 설정한 새 기능에 대한 SPFeatureDefinition 개체가 반환됩니다.

참고

Url 매개 변수를 팜 범위 기능에 사용하는 경우
"'<기능 이름>' 기능은 전체 팜에 적용됩니다. 팜 범위 기능에는 Url 매개 변수를 사용할 수 없습니다."라는 오류 메시지가 나타납니다.

SharePoint 제품용 Windows PowerShell에 대한 사용 권한 및 최신 정보는 온라인 설명서(https://go.microsoft.com/fwlink/?LinkId=163185)를 참고하십시오.

Parameters

매개 변수 필수 형식 설명

Identity

필수

Microsoft.SharePoint.PowerShell.SPFeatureDefinitionPipeBind

사용하도록 설정할 기능의 이름이나 GUID를 지정합니다.

형식은 14\Template\Features 폴더에 있는 Feature 폴더의 이름 또는 21d186e1-7036-4092-a825-0eb6709e9281 형식의 GUID 이름이어야 합니다.

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

기능을 강제로 활성화합니다. 그러면 기능에 연결된 사용자 지정 코드가 다시 실행됩니다.

PassThru

선택

System.Management.Automation.SwitchParameter

제공하면 cmdlet에서 기능 정의 개체를 사용하도록 설정한 후 출력합니다.

Url

선택

System.String

기능이 활성화되는 웹 응용 프로그램, 사이트 모음 또는 웹 사이트의 URL을 지정합니다.

형식은 유효한 URL(예: http://서버_이름)이어야 합니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

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

입력 형식

반환 형식

Example

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

Enable-SPFeature -identity "MyCustom" -URL http://somesite

이 예제에서는 http://somesite에서 "MyCustom" 사이트 범위 SharePoint 기능을 사용하도록 설정합니다.

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

$w = Get-SPWeb http://somesite/myweb | ForEach{ $_.URL }

Get-SPFeature -Web $w |%{ Enable-SPFeature -Identity $_ -URL $w}

이 예제에서는 http://somesite/myweb의 하위 사이트에서 모든 SharePoint 기능을 사용하도록 설정합니다.

See Also

Reference

Disable-SPFeature
Install-SPFeature
Uninstall-SPFeature
Get-SPFeature