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