SharePoint Server에서 사용자 지정 내용 복원

아티클
03/08/2023

적용 대상: yes-img-13 2013 yes-img-16 2016 yes-img-19 2019 yes-img-se Subscription Edition no-img-sop SharePoint in Microsoft 365

중앙 관리 또는 PowerShell을 사용하여 SharePoint Server에 수행된 모든 사용자 지정을 복원할 수 있습니다. 배포한 환경의 종류, 일정 요구 사항 및 조직과의 서비스 수준 계약에 따라 사용하는 복원 도구가 달라집니다.

시작하기 전에

이 작업을 시작하기 전에 다음 정보를 검토하십시오.

신뢰할 수 있는 솔루션과 샌드박스 솔루션 모두의 .wsp 파일을 만드는 데 사용되는 원본 코드는 물론 원본 .wsp 파일의 백업을 유지하는 것이 좋습니다.

SharePoint server에서 솔루션 패키지 복원

솔루션 패키지를 복원하는 데 사용하는 방법은 사용자 지정 내용이 신뢰할 수 있는 솔루션으로 배포되었는지 아니면 샌드박스 솔루션으로 배포되었는지에 따라 결정됩니다.

신뢰할 수 있는 솔루션은 팜 관리자가 배포하는 솔루션입니다. 전체 팜에 배포되며 팜 내의 모든 사이트에서 사용할 수 있습니다. 신뢰할 수 있는 솔루션은 구성 데이터베이스에 저장됩니다. 신뢰할 수 있는 솔루션은 SharePoint Server 백업을 사용하여 팜을 백업할 때 백업되며 구성 전용 백업에 포함되며 그룹으로 또는 개별적으로 백업할 수도 있습니다. 복원 계층 구조에 표시됩니다.

샌드박스 솔루션은 사이트 모음 관리자가 단일 사이트 모음에 배포할 수 있는 솔루션입니다. 샌드박스 솔루션은 배포된 사이트 모음과 연결된 콘텐츠 데이터베이스에 저장됩니다. SharePoint Server 팜, 웹 애플리케이션, 콘텐츠 데이터베이스 및 사이트 모음 백업에 포함되지만 복원 계층 구조에는 표시되지 않으며 개별적으로 선택하거나 복원할 수 없습니다.

중앙 관리를 사용하여 신뢰할 수 있는 솔루션을 복원하려면

이 절차를 수행하는 사용자 계정이 Farm Administrators SharePoint 그룹의 구성원인지 확인합니다.
중앙 관리를 시작합니다.
중앙 관리 홈 페이지의 백업 및 복원 섹션에서 백업에서 복원을 클릭합니다.
백업에서 복원 - 3단계 중 1단계: 복원할 백업 선택 페이지의 백업 목록에서 솔루션 패키지가 포함된 백업 작업을 선택하고 다음을 클릭합니다. 백업 옆의 더하기 기호(+)를 클릭하면 각 백업에 대한 더 많은 세부 정보를 확인할 수 있습니다.

참고

올바른 백업 작업이 나타나지 않으면 백업 디렉터리 위치 텍스트 상자에 올바른 백업 폴더의 UNC(Universal Naming Convention) 경로를 입력한 다음 새로 고침을 클릭합니다.
백업에서 복원 - 3단계 중 2단계: 복원할 구성 요소 선택 페이지에서 솔루션 옆에 있는 확인란을 선택하고 다음을 클릭합니다.
백업에서 복원 - 3단계 중 3단계: 복원 옵션 선택 페이지의 구성 요소 복원 섹션에서 솔루션이 다음 구성 요소 복원 목록에 나타나는지 확인합니다.

구성 설정만 복원 섹션에서 콘텐츠 및 구성 설정 복원 옵션이 선택되어 있는지 확인합니다.

복원 옵션 섹션의 복원 유형에서 같은 구성 옵션을 선택합니다. 작업을 확인하라는 대화 상자가 나타납니다. 확인을 클릭합니다.

복원 시작을 클릭합니다.
백업 및 복원 작업 상태 페이지의 맨 위, 준비 섹션에서 모든 복구 작업의 일반적인 상태를 확인할 수 있습니다. 페이지 아래쪽의 복원 섹션에서는 현재 복구 작업의 상태를 확인할 수 있습니다. 상태 페이지는 30초마다 자동으로 업데이트됩니다. 새로 고침을 클릭하여 상태 세부 정보를 수동으로 업데이트할 수도 있습니다. 백업 및 복구는 Timer Service 작업입니다. 따라서 복구를 시작하는 데 몇 초 정도 걸릴 수 있습니다.

오류가 발생하는 경우 백업 및 복원 작업 상태 페이지의 실패 메시지 열에서 해당 오류를 검토할 수 있습니다. 또한 3단계에서 지정한 UNC 경로에 있는 Sprestore.log 파일에서 더 많은 세부 정보를 확인할 수도 있습니다.

PowerShell을 사용하여 신뢰할 수 있는 솔루션을 복원하려면

다음 멤버 자격이 있는지 확인합니다.
- SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할
- 업데이트하려는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할
- PowerShell cmdlet을 실행 중인 서버의 Administrators 그룹
  
  관리자는 Add-SPShellAdmin cmdlet을 사용하여 SharePoint Server cmdlet 사용 권한을 부여할 수 있습니다.
참고

권한이 없는 경우 설치 관리자 또는 SQL Server 관리자에게 문의하여 권한을 요청하십시오. PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.
SharePoint 관리 셸을 시작합니다.
PowerShell 명령 프롬프트에 다음 명령을 입력합니다.
```
Restore-SPFarm -Directory <BackupFolder> -RestoreMethod Overwrite -BackupId <GUID> -Item <SolutionPath>
```
여기서 각 부분이 나타내는 의미는 다음과 같습니다.
- <BackupFolder>는 복원 원본 디렉터리의 UNC 위치입니다.
- <GUID> 는 복원하려는 백업 ID의 GUID입니다. 백업을 지정하지 않으면 가장 최근 백업이 사용됩니다.
- <SolutionPath> 는 백업 트리 내의 솔루션 경로입니다(일반적으로 farm\solutions\ SolutionName).

자세한 내용은 Restore-SPFarm을 참조하십시오.

참고

명령줄 관리 작업을 수행하는 경우 Windows PowerShell을 사용하는 것이 좋습니다. Stsadm 명령줄 도구는 더 이상 사용되지 않지만 이전 제품 버전과의 호환성을 지원하기 위해 포함됩니다.

샌드박스 솔루션 복원

샌드박스 솔루션으로 배포된 사용자 지정 내용만 복원할 수는 없습니다. 대신 사용자 지정 내용이 연결된 팜, 웹 응용 프로그램, 콘텐츠 데이터베이스 또는 사이트 모음을 복원해야 합니다.

SharePoint Server에서 제작된 사이트 요소 복원

제작된 사이트 요소만 복원할 수는 없습니다. 대신 제작된 사이트 요소가 연결된 팜, 웹 응용 프로그램 또는 콘텐츠 데이터베이스를 복원해야 합니다.

SharePoint Server에서 워크플로 복원

워크플로는 복원이 가능한 특수한 사용자 지정입니다. 백업 및 복구 계획에 해당 환경에 적용되는 다음과 같은 시나리오가 포함되어 있는지 확인하십시오.

SharePoint Designer에서 만든 워크플로와 같은 선언적 워크플로는 배포되는 사이트 모음의 콘텐츠 데이터베이스에 저장됩니다. 콘텐츠 데이터베이스 또는 사이트 모음을 복원하면 이러한 워크플로가 복원됩니다.
사용자 지정 선언적 워크플로 작업의 구성 요소는 다음과 같은 세 위치에 있습니다.
- 작업에 대한 Visual Studio 2013 어셈블리는 GAC(전역 어셈블리 캐시)에 저장됩니다.
- XML 정의 파일(.actions 파일)은 16\TEMPLATE<LCID>\Workflow 디렉터리에 저장됩니다.
- 작업을 승인된 유형으로 표시하기 위한 XML 항목은 해당 항목이 사용되는 웹 응용 프로그램의 Web.config 파일에 저장됩니다.
  
  팜 워크플로에서 사용자 지정 작업을 사용하는 경우 파일 복원 시스템을 통해 이러한 파일과 XML 항목을 복원해야 합니다. 복구 후에 필요에 따라 파일을 다시 적용할 수도 있습니다.
Visual Studio 2013을 사용하여 만든 것과 같은 사용자 지정 코드에 의존하는 워크플로는 두 위치에 저장됩니다. 워크플로에 대한 Visual Studio 2013 어셈블리는 GAC에 저장되고 XML 정의 파일은 기능 디렉터리에 저장됩니다. 이는 웹 파트 및 이벤트 수신기와 같은 다른 유형의 SharePoint Server 기능과 동일합니다. 워크플로가 솔루션 패키지의 일부로 설치된 경우 솔루션 패키지를 복원하기 위한 지침을 따릅니다.
워크플로가 배포되는 사이트 모음이 아닌 다른 사이트 모음과 상호 작용하는 사용자 지정 워크플로를 만드는 경우 워크플로를 복구하려면 두 사이트 모음을 모두 복원해야 합니다. 팜의 모든 사이트 모음 및 이러한 사이트 모음과 연결된 모든 워크플로를 복구하려면 팜 복원을 수행하는 것으로 충분합니다.
배포되지 않은 워크플로는 파일 시스템 백업 응용 프로그램을 사용하여 별도로 복원해야 합니다.

SharePoint Server에서 Web.config 파일 변경 내용 복원

팜 또는 구성 전용 복원을 수행하여 중앙 관리 또는 SharePoint Server API와 개체 모델을 통해 적용된 Web.config 파일의 변경 내용을 복구할 수 있습니다.

파일 시스템 백업을 사용하여 중앙 관리 또는 SharePoint API 및 개체 모델을 사용하지 않는 Web.config 파일의 변경 내용을 보호해야 합니다. 파일 시스템 복원을 사용하면 백업을 복구할 수 있습니다.

SharePoint Server에서 솔루션으로 패키지되지 않은 개발된 사용자 지정 내용 복원

사용자 지정 파일 위치가 표준화되어 있지 않으므로 솔루션으로 패키지되지 않은 개발된 사용자 지정 내용을 복원하는 프로세스는 복잡해질 수 있습니다.

개발 팀이나 사용자 지정 내용 공급업체에 문의하여 사용자 지정 내용과 관련된 다른 추가 기능 소프트웨어나 파일이 다른 위치에 있는지 여부를 확인합니다. 이러한 디렉터리는 파일 시스템 복원 솔루션을 사용하여 복원하는 것이 좋습니다. 다음 표에는 웹 서버에서 사용자 지정 내용이 일반적으로 저장되는 위치가 나와 있습니다.

위치	설명
%PROGRAMFILES%\Common files\Microsoft Shared\Web Server Extensions\16	일상적으로 업데이트되는 파일, 사용자 지정 어셈블리, 사용자 지정 서식 파일, 사용자 지정 사이트 정의
Inetpub	IIS 가상 디렉터리의 위치
%WINDIR%\Assembly	GAC(전역 어셈블리 캐시): 전체 시스템 액세스를 제공하기 위해 Microsoft .NET Framework 코드 어셈블리가 설치되는 보호되는 운영 체제 위치