SharePoint Server 2013에서 업그레이드된 사이트 모음에 사용자 지정 기능 배포

적용 대상:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

이 문서에서는 솔루션 패키지를 통해 SharePoint Server 2010에서 업그레이드된 SharePoint Server 2013 팜에 사용자 지정 기능을 배포하는 방법을 설명합니다. 여기에는 지원되는 시나리오에 대한 정보 및 절차가 포함됩니다. 기능 마스킹도 소개합니다.

알아야 할 사항

이 섹션에서는 시작하기 전에 알아야 할 필수 정보에 대해 설명합니다. 포함된 내용은 다음과 같습니다.

이 문서를 읽어야 하는 대상 사용자 및 그 이유

이 문서는 SharePoint Server 2013 팜의 여러 사이트 모음에서 완전 신뢰 코드 기반 사용자 지정 기능을 배포하고 유지 관리하기 위해 개발자와 협력해야 하는 IT 전문가를 위한 것입니다. SharePoint 2013으로 업그레이드할 때 레거시 사용자 지정 기능을 사용하는 방법과 사이트 모음이 호환 모드에서 업그레이드될 때 사용자에게 원활하게 작동하도록 하는 데 도움이 되는 작업을 알아보려면 이 문서를 참조하세요. 이 문서는 개발자를 위한 보다 자세한 내용을 제공하는 추가 문서로 연결됩니다.

SharePoint Server 2010 팜이 SharePoint Server 2013으로 업그레이드되면 모든 사이트 모음이 SharePoint 2010 호환 모드에서 실행됩니다. 각 사이트 모음이 SharePoint 2013 모드로 업그레이드될 때까지 이 모드로 유지됩니다. 이렇게 하면 사용자는 개별 사이트 모음을 업그레이드할 때까지 익숙한 SharePoint Server 2010 사용자 인터페이스 및 기능을 사용할 수 있습니다. SharePoint Server 2010에서 사용했을 수 있는 레거시 사용자 지정 기능을 사용할 수도 있습니다. 결국 사이트 모음을 SharePoint 2013 모드로 업그레이드하여 제공하는 새로운 기능과 기능을 활용하려고 합니다. 이 업그레이드를 수행하면 SharePoint 2010 호환성 모드에서 작동했던 사용자 지정 기능이 더 이상 작동하지 않을 수 있습니다. SharePoint 모드가 바뀌어도 사용 중이던 동일한 기능을 계속 사용할 수 있는지 확인해야 합니다. 이 문서에서는 이 방법을 설명합니다.

잘 알고 있어야 하는 Microsoft PowerShell cmdlet

이 문서를 읽기 전에 다음 PowerShell cmdlet을 잘 알고 있어야 합니다.

이름	수행 작업	예제
Add-SPSolution	팜의 솔루션 저장소에 솔루션을 추가합니다.	Add-SPSolution -LiteralPath c:\contoso_solution.wsp
Install-SPSolution	팜의 솔루션 저장소에 추가된 솔루션을 배포합니다.	Install-SPSolution -Identity contoso_solution.wsp -GACDeployment -CompatibilityLevel 15
Uninstall-SPSolution	배포된 솔루션을 취소합니다.	Uninstall-SPSolution -Identity contoso_solution.wsp
Remove-SPSolution	배포된 솔루션을 제거합니다.	Remove-SPSolution -Identity contoso_solution.wsp

솔루션 패키지 배포 개요

다음 섹션을 이해하려면 사용자 지정 기능이 SharePoint 2013 팜에 배포되는 방식을 이해해야 합니다.

SharePoint Server 2010을 SharePoint 2013 팜으로 업그레이드할 때는 사용자 지정 기능을 추가하는 작업이 중요한 단계입니다.

그림: 업그레이드 프로세스에서 사용자 지정 기능 추가

솔루션 패키지를 사용하여 새 팜에 사용자 지정을 추가할 수 있습니다. 솔루션 패키지는 사용자 지정 SharePoint 2013 개발 작업을 서버 팜의 웹 서버 또는 애플리케이션 서버에 전달하는 배포 패키지입니다. 솔루션을 사용하여 사용자 지정 기능, 사이트 서식 파일, 웹 서식 파일, 레이아웃 페이지, 웹 파트, CSS 스타일시트 및 타이머 작업을 패키지로 만들고 배포할 수 있습니다.

SharePoint 2013 팜에 솔루션 패키지를 배포하려면 다음을 수행해야 합니다.

1. 팜에 솔루션 패키지 추가. Add-SPSolution PowerShell cmdlet을 사용하여 SharePoint 솔루션 패키지를 팜에 업로드합니다. 그러면 팜의 구성 데이터베이스에 있는 팜의 솔루션 저장소에 솔루션이 추가됩니다.

2. 팜에 솔루션 패키지 배포. Install-SPSolution PowerShell cmdlet을 사용하여 SharePoint 솔루션 패키지를 팜에 배포합니다. 이렇게 하면 솔루션 패키지의 압축을 풀고 사용자 지정 기능이 포함된 모든 파일을 팜의 프런트 엔드 웹 서버에 있는 "기능" 디렉터리에 복사합니다. 각 사용자 지정 기능에 대한 하위 폴더가 만들어지고 Feature.xml 파일이 포함됩니다. 이 파일은 기능의 기본 속성과 해당 속성에 바인딩된 요소뿐만 아니라 기능을 구성하는 요소를 정의하는 하나 이상의 요소 매니페스트 파일(elements.xml)을 정의합니다.

Install-SPSolution PowerShell cmdlet에는 SharePoint 2010 모드 또는 SharePoint 2013 모드 사이트 모음에 대해 지정된 루트 폴더의 위치에 솔루션 패키지를 배포하는 호환성 수준 매개 변수도 포함되어 있습니다. "14" 및 "15" 루트 폴더(하이브)이며 솔루션을 배포할 때 기능, 레이아웃 파일, 이미지 및 컨트롤 템플릿과 같은 파일이 여기에 추가됩니다.

그림: SharePoint 2010 및 2013 루트 폴더

또한 SharePoint 2013 팜에 솔루션 패키지를 배포할 때 호환성 수준에 관계없이 일부 파일이 특정 위치에 복사됩니다. 파일이 복사되는 위치에 대한 자세한 내용은 SharePoint 2013용 팜 솔루션 배포 계획을 참조하세요.

팜의 어떤 모드의 사이트 모음도 해당하는 하이브를 가리키므로 솔루션 패키지에 제공된 사용자 지정 기능을 사용할 수 있습니다.

그림: SharePoint Server 2013으로 업그레이드한 후에 레거시 사용자 지정 기능 배포

사용자 지정 기능이 SharePoint 2010 및 SharePoint 2013 모드 둘 다에서 제대로 작동하는지 테스트를 했을 수 있습니다. 이 경우 기능 어셈블리 파일이 동일할 수 있습니다. 예를 들어 사용자 지정 기능인 Feature1이 SharePoint 2013 및 SharePoint 2010 모드에서 작동하는 것으로 알려진 경우 동일한 솔루션 패키지를 사용하여 동일한 사용자 지정 기능(Feature1)을 "14" 및 "15" 폴더에 배포할 수 있습니다.

그렇지만 테스트한 결과, 해당 레거시 사용자 지정 기능이 SharePoint 2013 모드의 사이트 모음에서 작동되지 않는 것으로 확인되면 다음과 같은 변경이 필요할 수 있습니다.

• SharePoint 사이트 모음 모드를 기반으로 하는 기능을 사용할 수 있도록 하는 조건부 논리를 포함하도록 솔루션 패키지를 업데이트합니다.

• 업그레이드된 사이트 모음에 사용될 경우 기능에 대한 업데이트된 세부 기능을 사용해서 새로운 솔루션 패키지를 따로 만듭니다.

기능 마스킹은 업그레이드된 사이트 및 사이트 모음에 대해 동일한 기능을 제공하는 별도의 새 솔루션 패키지를 사용하는 것을 의미합니다(기능 범위가 사이트 또는 사이트 모음일 경우). 기능 마스킹을 사용하면 업그레이드된 사이트 모음이 올바른 사용자 지정 기능 어셈블리를 자동으로 찾아서 사용할 수 있습니다. 이러한 방식으로 사용자는 동일한 사용자 지정 기능을 원활하게 사용할 수 있게 됩니다.

SharePoint Server 2013 팜의 레거시 사용자 지정 기능

SharePoint 2013 팜의 레거시 사용자 지정 기능을 사용할 때는 다음 세 가지 상황 중 하나가 될 수 있습니다.

• 솔루션 패키지에서 제공하는 사용자 지정 기능은 현재 SharePoint 2010 모드의 사이트 모음에서 작동합니다. 또한 SharePoint 2013 모드의 사이트 모음에도 작동합니다.

• 솔루션 패키지에서 제공하는 사용자 지정 기능은 현재 SharePoint 2010 모드의 사이트 모음에서 작동합니다. 또한 SharePoint 2013 모드의 사이트 모음에도 작동합니다. 또한 나중에 SharePoint 2013 모드에서 사이트 모음에 대해 증분 방식으로 추가할 수 있는 추가 사용자 지정 기능 기능도 고려해야 합니다.

• 솔루션 패키지에서 제공하는 사용자 지정 기능은 현재 SharePoint 2010 모드의 사이트 모음에서 작동합니다. 그러나 SharePoint 2013 모드의 사이트 모음에는 작동하지 않습니다.

지원되는 시나리오

SharePoint Server 2010에서 업그레이드된 SharePoint 2013 팜에 사용자 지정 기능을 배포할 때는 다음과 같은 세 가지 배포 시나리오가 지원됩니다.

시나리오 1	SharePoint 2010 호환성 모드를 위한 레거시 솔루션, 기능이 SharePoint 2013 모드로 업그레이드될 때도 동일하게 유지될 것으로 예상
시나리오 2	SharePoint 2010 호환성 모드를 위한 레거시 솔루션, SharePoint 2013 모드에 대한 기능을 점진적으로 추가하기 위해 새로운 솔루션이 다시 구축
시나리오 3	SharePoint 2010 호환성 모드를 위한 레거시 솔루션, SharePoint 2013의 새 기능을 구현하기 위한 새로운 솔루션 구축

시나리오 1: SharePoint 2010 호환성 모드를 위한 레거시 솔루션, 기능이 SharePoint 2013으로 업그레이드될 때도 동일하게 유지될 것으로 예상

이 시나리오에서는 현재 솔루션 패키지를 통해 제공되는 사용자 지정 기능이 SharePoint 2010 호환성 모드의 사이트 모음에서 제대로 작동합니다. 또한 사이트 모음이 SharePoint 2013 모드로 업그레이드될 때 작동할 것으로 예상됩니다. 예를 들어 SharePoint 2010용의 사용자 지정 웹 파트가 만들어졌습니다. 코드를 변경하지 않고 SharePoint 2013에서 작동하도록 테스트되었습니다. SharePoint 2013 팜에 추가할 수 있으며 SharePoint 2010 호환성 모드의 사이트 모음 사용자 및 SharePoint 2013으로 사이트를 업그레이드할 때 작동합니다.

사용자 지정 기능은 두 SharePoint 모드에서 작동할 것으로 예상되므로 동일한 사용자 지정 기능 어셈블리를 사용할 수 있습니다. 그러나 Install-SPSolution cmdlet을 사용할 때 매개 변수를 사용하여 수행할 수 있는 두 SharePoint 모드에 대한 솔루션 패키지를 배포하는 것이 중요합니다. 이 시나리오에서는 두 모드의 사이트 모음이 동일한 코드(해당 2010 및 2013 모드 폴더에 중복된 기능 어셈블리 포함)를 사용하므로 기능 마스킹이 사용되지 않습니다.

이 시나리오의 단계에는 다음이 포함됩니다.

1. 사용자 지정 기능을 포함하는 솔루션 패키지를 만듭니다.

2. 팜에 솔루션 패키지를 추가합니다. Add-SPSolution PowerShell cmdlet을 통해 이 작업을 수행할 수 있습니다. 예를 들면

   Add-SPSolution -LiteralPath c:\Solution.wsp

3. 솔루션 패키지를 배포합니다.

4. SharePoint 2010 호환성을 위한 솔루션 패키지를 배포합니다. Install-SPSolution PowerShell cmdlet을 사용하여 이 작업을 수행할 수 있습니다. -CompatibilityLevel 매개 변수를 14로 설정해야 합니다. 예를 들면

   Install-SPSolution -Identity Solution.wsp -CompatibilityLevel 14 -GAC ...

5. SharePoint 2013 호환성을 위한 솔루션 패키지를 배포합니다. Install-SPSolution PowerShell cmdlet을 사용하여 이 작업을 수행할 수 있습니다. -CompatibilityLevel 매개 변수를 15로 설정해야 합니다. 예를 들면

   Install-SPSolution -Identity Solution.wsp -CompatibilityLevel 15 -GAC ...

시나리오 2: SharePoint 2010 호환성 모드를 위한 레거시 솔루션, SharePoint 2013 모드에 대한 기능을 점진적으로 추가하기 위해 새로운 솔루션이 다시 구축

이 시나리오에서 사용자 지정 기능은 SharePoint Server 2010에서 올바르게 작동합니다. 이 기능을 SharePoint 2013 팜에 추가하여 솔루션 패키지를 빌드하려고 하지만 이 솔루션 패키지를 사용하는 SharePoint 2013 모드에서 사이트 모음에 대한 기능을 증분 방식으로 추가할 수도 있습니다. 예를 들어 SharePoint 2010용의 사용자 지정 웹 파트가 만들어졌습니다. 코드를 변경하지 않고 SharePoint 2013에서 작동하도록 테스트되었습니다. 그러나 SharePoint 2013 사용자에 대한 추가 기능을 추가할 수도 있지만 이전 버전과의 호환성을 허용하기 위해 동일한 기능 어셈블리를 사용하려고 합니다.

사용자 지정 기능은 두 SharePoint 모드에서 작동할 것으로 예상되므로 동일한 사용자 지정 기능 어셈블리를 사용할 수 있습니다. 이전 시나리오와 마찬가지로 두 SharePoint 모드에 대해 솔루션 패키지를 설치해야 합니다. 이 시나리오의 주요 차이점은 솔루션 패키지에 조건부로 사이트 모음 호환성을 기반으로 하는 기능 세부 기능을 허용하는 논리가 포함되어야 한다는 것입니다.

예를 들어 SharePoint 2010용으로 설계된 사용자 지정 기능에 샘플()이라는 메서드가 구현되어 있다고 가정해 보겠습니다. SharePoint 2013 모드에서 구현을 변경하려면 코드에 SPSite.CompatibilityLevel 속성을 사용하는 조건부 논리가 포함되어야 합니다.

void Sample()
{
if (site.CompatibilityLevel == 14) { /*Existing O14 implementation*/}
else {/*New O15 implementation*/}}
}

이렇게 하면 동일한 기능 어셈블리가 SharePoint 2010 및 SharePoint 2013 버전의 기능을 모두 제공합니다. 동일한 기능 어셈블리뿐만 아니라 동일한 솔루션 패키지를 사용하기 때문에 이 시나리오에서는 기능 마스킹이 사용되지 않습니다. 사용자 지정 기능에 대한 동일한 파일이 "14" 및 "15" \Template\Features 디렉터리에 복사됩니다. 자세한 내용은 TechNet 블로그 게시물 SharePoint 2013용 팜 솔루션 배포 계획의 "계획 고려 사항" 섹션을 참조하세요.

이 시나리오의 단계에는 다음이 포함됩니다.

1. 사용자 지정 기능을 포함하는 솔루션 패키지를 만듭니다. 사이트 모음 호환성을 기반으로 하는 기능 세부 기능을 사용할 수 있도록 하는 조건부 논리를 포함합니다.

2. 팜에 솔루션 패키지를 추가합니다. Add-SPSolution PowerShell cmdlet을 사용하여 이 작업을 수행할 수 있습니다. 예를 들면

   Add-SPSolution -LiteralPath c:\Solution.wsp

3. 솔루션 패키지를 배포합니다.

4. SharePoint 2010 호환성을 위한 솔루션 패키지를 배포합니다. Install-SPSolution PowerShell cmdlet을 사용하여 이 작업을 수행할 수 있습니다. -CompatibilityLevel 매개 변수를 14로 설정해야 합니다. 예를 들면

   Install-SPSolution -Identity Solution.wsp -CompatibilityLevel 14 -GAC ...

5. SharePoint 2013 호환성을 위한 솔루션 패키지를 설치합니다. Install-SPSolution PowerShell cmdlet을 사용하여 이 작업을 수행할 수 있습니다. -CompatibilityLevel 매개 변수를 15로 설정해야 합니다. 예를 들면

   Install-SPSolution -Identity Solution.wsp -CompatibilityLevel 15 -GAC ...

시나리오 3: SharePoint 2010 호환성 모드를 위한 레거시 솔루션, SharePoint Server 2013의 새 기능을 구현하기 위한 새로운 솔루션 구축

이 시나리오에서는 사용자 지정 기능이 SharePoint Server 2010에서 올바르게 작동하는 것으로 알려져 있지만 SharePoint 2013에서는 작동하지 않는 것으로 알려져 있습니다. SharePoint 2013에서 사용자 지정 기능의 기능이 올바르게 작동하도록 수정된 새 솔루션 패키지를 만들어야 합니다. 이 시나리오에는 서로 다른 기능 어셈블리가 있는 두 개의 서로 다른 솔루션 패키지가 있습니다. 이 시나리오에서는 기능 마스킹을 사용합니다. 사용자가 호환 모드에서 SharePoint 2013으로 이동함에 따라 사용하는 사용자 지정 기능이 서로 다른 코드 베이스에서 다른 코드 베이스로 이동되었다는 사실에서 "마스킹"됩니다.

이 시나리오에서는 두 개의 다른 기능 어셈블리를 포함하는 두 개의 개별 솔루션 패키지를 추가하고 배포해야 합니다. 기능의 두 버전은 기능 어셈블리와 리소스가 다르더라도 이름, 기능 ID 및 기능 매니페스트 위치가 같아야 합니다.

기능 마스킹 요구 사항

요구 사항	같음 또는 다름	솔루션 패키지 – 2010 모드 예제	솔루션 패키지 – 2013 모드 예제
솔루션 패키지 이름	다름	POC14	POC15
솔루션 패키지 ID	다름	000000-0000-0000-0000-000000000000	11111111-1111-1111-1111-111111111111
기능 이름	같음	Feature1	Feature1
기능 ID	같음	12345	12345
기능 XML 폴더 이름	같음	POC15\Features\Feature1.feature\	POC15\Features\Feature1.feature\
기능 매니페스트 위치	같음	POC15_Feature1\Feature1.Template.xml	POC15_Feature1\Feature1.Template.xml

그림: 기능 마스킹을 위한 솔루션 패키지

이 시나리오의 단계에는 다음이 포함됩니다.

1. 이름이 다른 두 개의 다른 솔루션 패키지를 만듭니다. 배포하는 기능의 버전에는 동일한 기능 이름과 ID가 있어야 합니다.

2. SharePoint 2010 호환성을 위한 솔루션 패키지를 팜에 추가합니다. Add-SPSolution PowerShell cmdlet을 통해 이 작업을 수행할 수 있습니다. 예를 들면

   Add-SPSolution -LiteralPath c:\POC14.wsp

3. SharePoint 2013 호환성을 위한 솔루션 패키지를 팜에 추가합니다. Add-SPSolution PowerShell cmdlet을 통해 이 작업을 수행할 수도 있습니다. 예를 들면

   Add-SPSolution -LiteralPath c:\POC15.wsp

4. SharePoint 2010 호환성을 위한 솔루션 패키지를 배포합니다. Install-SPSolution PowerShell cmdlet을 통해 이 작업을 수행할 수 있습니다. -CompatibilityLevel 매개 변수를 14로 설정해야 합니다. 예를 들면

   Install-SPSolution -Identity POC14.wsp -CompatibilityLevel 14 -GAC ...

5. SharePoint 2013 호환성을 위한 솔루션 패키지를 설치합니다. Install-SPSolution PowerShell cmdlet을 통해 이 작업을 수행할 수도 있습니다. -CompatibilityLevel 매개 변수를 15로 설정해야 합니다. 예를 들면

   Install-SPSolution -Identity POC15.wsp -CompatibilityLevel 15 -GAC ...

솔루션 패키지 제거

모든 사이트 모음이 SharePoint 2013 모드로 업그레이드되면 SharePoint 2010 호환성 모드 사이트 모음에 대해 배포한 레거시 솔루션 패키지가 더 이상 필요하지 않습니다. 이 경우 레거시 솔루션 패키지를 SharePoint Server 2013 팜에서 취소한 후 제거할 수 있습니다. Uninstall-SPSolution 및 Remove-SPSolution PowerShell cmdlet을 통해 이 작업을 수행할 수 있습니다.

솔루션 패키지를 취소하고 제거하려면

1. 팜에서 SharePoint 2010 모드 솔루션 패키지 철회: Uninstall-SPSolution Windows PowerShell cmdlet을 통해 이 작업을 수행할 수 있습니다. 예를 들면

   Uninstall-SPSolution -Identity POC14.wsp -CompatibilityLevel 14

   중요

   CompatibilityLevel 매개 변수를 "14"로 사용하여 2010 호환성 모드에 대해서만 솔루션 패키지를 철회해야 합니다. 예: Uninstall-SPSolution POC14.wsp -CompatibilityLevel 14

2. 팜의 솔루션 저장소에서 솔루션 패키지 제거: Remove-SPSolution PowerShell cmdlet을 통해 이 작업을 수행할 수 있습니다. 예를 들면

   Remove-SPSolution -Identity POC14.wsp

기타 고려 사항

이 섹션에는 다음을 비롯한 추가 고려 사항에 대한 정보가 포함되어 있습니다.

• 혼합 모드를 사용하여 사이트 모음의 기능 배포

• 마스터 페이지 고려 사항

혼합 모드를 사용하여 사이트 모음의 기능 배포

사용자 지정 기능이 팜 또는 웹 응용 프로그램 범위인 경우 팜 또는 웹 응용 프로그램 내의 모든 사이트 모음이 SharePoint 2013 호환성 모드로 업그레이드되지 않았더라도 배포할 수 있습니다.

웹 애플리케이션 범위 기능의 경우 루트 사이트 모음이 업그레이드되지 않은 경우 Install-SPSolution PowerShell cmdlet을 사용하여 기능을 활성화할 수 없습니다. 대신 SharePoint 중앙 관리 사이트를 사용하여 기능을 활성화해야 합니다.

마스터 페이지 고려 사항

브랜딩 사용자 지정과 관련하여 사용자 지정 마스터 페이지는 SharePoint 2013에서 사이트 모음 업그레이드 후 기본적으로 seattle.master로 다시 설정됩니다. 기능 마스킹 시나리오를 사용하는 경우 SharePoint 2013 사이트 모음에 대해 만든 사용자 지정 마스터 페이지를 다시 설정해야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 MSDN 문서 기능 업그레이드를 사용하여 SharePoint 2010에서 업그레이드할 때 새 SharePoint Server 2013 마스터 페이지를 적용합니다.

참고 항목

기타 리소스

SharePoint 2013으로 업그레이드하는 중에 현재 사용자 지정 내용에 대한 계획 세우기

브랜딩 및 사이트 프로비저닝을 위한 Microsoft 365 솔루션 팩의 SharePoint 2013 및 SharePoint

SharePoint 2013으로 업그레이드할 때 발생할 수 있는 브랜딩 문제