Restore-SPFarm

아티클
10/14/2016

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

마지막으로 수정된 항목: 2015-03-09

백업에서 항목을 하나 이상 복원합니다.

Syntax

Restore-SPFarm -Directory <String> -RestoreMethod <String> [-AssignmentCollection <SPAssignmentCollection>] [-BackupId <Guid>] [-ConfigurationOnly <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-FarmCredentials <PSCredential>] [-Force <SwitchParameter>] [-Item <String>] [-NewDatabaseServer <String>] [-Percentage <Int32>] [-RestoreThreads <Int32>] [-WhatIf [<SwitchParameter>]]

Restore-SPFarm -Directory <String> -ShowTree <SwitchParameter> [-AssignmentCollection <SPAssignmentCollection>] [-BackupId <Guid>] [-ConfigurationOnly <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-Item <String>] [-WhatIf [<SwitchParameter>]]

자세한 설명

Restore-SPFarm cmdlet은 개별 데이터베이스, 웹 응용 프로그램 또는 전체 팜과 같은 항목을 백업에서 하나 이상 복원합니다. 이 cmdlet은 전체 팜에 팜 서식 파일을 적용하는 데 사용할 수도 있습니다.

Parameters

매개 변수	필수	형식	설명
Directory	선택	System.String	SharePoint 2010 제품에서 백업 패키지를 저장한 위치의 경로를 지정합니다. Microsoft SQL Server 2008 및 SharePoint 2010 제품의 인스턴스가 설치된 하나의 컴퓨터가 있는 경우 로컬 드라이브 경로를 사용할 수 있습니다. 기본 설치가 여기에 포함됩니다. 그러나 SQL Server 2008 및 SharePoint 2010 제품이 여러 컴퓨터에 설치되어 있는 경우에는 SQL Server 2008 및 SharePoint 2010 제품을 동일한 위치(예: \\컴퓨터_이름\volume\Backup)에서 읽을 수 있도록 UNC(Universal Naming Convention) 공유 경로를 사용해야 합니다. 형식은 다음과 같은 형식의 유효한 경로 중 하나여야 합니다. - C:\폴더_이름 - \\서버_이름\폴더_이름 Note spbr* 폴더가 자동으로 만들어집니다.
RestoreMethod	선택	System.String	수행할 복원 방법을 지정합니다. 유효한 값은 다음과 같습니다. - New: 콘텐츠를 복원할 새 위치를 지정합니다. 이는 다른 팜으로 복원할 때 사용할 수 있습니다. 새 설정을 지정하기 위해 추가 프롬프트가 제공됩니다. - Overwrite: 콘텐츠 및 설정을 원래 위치로 복원합니다. 이는 백업된 것과 동일한 팜으로 복원할 때 사용할 수 있습니다. Overwrite 매개 변수를 사용하면 확인 메시지가 표시됩니다. 확인 메시지를 표시하지 않으려면 Force 매개 변수를 사용하십시오.
ShowTree	선택	System.Management.Automation.SwitchParameter	Restore-SPFarm cmdlet으로 전달되는 다른 매개 변수(예: Item 및 ConfigurationOnly 매개 변수)를 기준으로 하여 복원할 팜의 개체를 표시합니다. Restore-SPFarm cmdlet으로 전달되는 다른 매개 변수를 기준으로 하여 복원에서 제외될 항목 앞에는 별표()가 붙고, 복원할 수 없는 항목은 대괄호([])로 묶입니다. ShowTree* 매개 변수가 있으면 복원 작업이 수행되지 않습니다.
AssignmentCollection	선택	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	올바른 삭제를 위해 개체를 관리합니다. SPWeb 또는 SPSite와 같은 개체를 사용하는 경우 많은 양의 메모리를 사용할 수 있으며, Windows PowerShell 스크립트에서 이러한 개체를 사용하려면 올바른 메모리 관리가 필요합니다. SPAssignment 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다. Note Global 매개 변수가 사용되는 경우 모든 개체가 전역 저장소에 포함됩니다. 개체가 즉시 사용되지 않거나 Stop-SPAssignment 명령을 사용하여 삭제되지 않는 경우 메모리 부족 시나리오가 발생할 수 있습니다.
BackupId	선택	System.Guid	복원할 백업 패키지의 GUID를 지정합니다. 각 백업 패키지에는 고유한 GUID가 연결되어 있으며, Get-SPBackupHistory cmdlet을 사용하여 백업 기록을 보면 GUID를 확인할 수 있습니다. 이 매개 변수를 지정하지 않으면 Directory 매개 변수를 사용하여 지정된 경로의 가장 최근 백업 패키지가 사용됩니다. 형식은 12345678-90ab-cdef-1234-567890abcdef 형식의 유효한 GUID여야 합니다.
ConfigurationOnly	선택	System.Management.Automation.SwitchParameter	백업 패키지에서 설정만(데이터 제외) 복원하여 대상 팜의 개체에 적용하도록 지정합니다.
Confirm	선택	System.Management.Automation.SwitchParameter	명령을 실행하기 전에 확인 메시지가 표시됩니다. 자세한 내용을 보려면 get-help about_commonparameters 명령을 입력하십시오.
FarmCredentials	선택	System.Management.Automation.PSCredential	복원되는 모든 구성 요소에 사용될 자격 증명(예: 복원되는 웹 응용 프로그램에 대한 응용 프로그램 풀 자격 증명)을 지정합니다. 복원되는 응용 프로그램 풀이 이미 팜에 있으면 해당 응용 프로그램 풀을 복원할 때 FarmCredentials 매개 변수에서 지정한 자격 증명이 무시됩니다.
Force	선택	System.Management.Automation.SwitchParameter	덮어쓰기 복원 작업을 실행할 때 구성 요소를 덮어쓰게 된다고 경고하는 메시지를 표시하지 않습니다.
Item	선택	System.String	복원할 백업 패키지 부분을 나타냅니다. ShowTree 매개 변수를 통해 표시되는 전체 팜 경로 표기법을 사용할 수도 있고, 고유한 이름이 있는 경우 경로의 대상 구성 요소 이름을 사용할 수도 있습니다. 이름이 일치하는 항목이 여러 개 있으면 전체 경로를 제공해야 합니다. 항목이나 경로에 공백이 있으면 따옴표로 묶습니다. 이 매개 변수가 없으면 전체 백업 패키지가 복원됩니다. 형식은 다음과 같은 유효한 항목이어야 합니다. Farm\Microsoft SharePoint Foundation Web Application\SharePoint - 80
NewDatabaseServer	선택	System.String	유효한 SQL 데이터베이스 서버 이름을 지정합니다. 지정하면 복원 작업 내의 모든 데이터베이스에 대한 기본 데이터베이스 서버 이름으로 사용됩니다. 이 매개 변수는 새로 복원하는 경우에만 유효하고 덮어쓰기 복원에는 유효하지 않습니다.
Percentage	선택	System.Int32	복원 작업에 대한 진행률 업데이트를 해당 백분율의 증분 방식으로 표시하도록 요청합니다. 예를 들어 값 5를 지정하면 5%가 완료될 때마다 복원 진행률 업데이트가 표시되고, 값 10을 지정하면 10%가 완료될 때마다 복원 진행률 업데이트가 표시됩니다. 참고: -Verbose 매개 변수를 지정하면 출력에만 진행률이 표시됩니다. 그렇지 않은 경우 복원 로그 파일에서 진행률을 확인할 수 있습니다. 이 백분율은 정확한 수치가 아니며, 실제 진행률 업데이트는 요청된 값보다 작거나 클 수 있습니다. 데이터베이스가 매우 큰 경우 값 1을 사용하는 것이 좋습니다. 형식은 1에서 100 사이의 정수 값이어야 합니다. 기본값은 5입니다.
RestoreThreads	선택	System.Int32	복원하는 동안 사용할 스레드 수입니다. 복원 스레드 수가 작을수록 복원 로그를 이해하기가 더 쉽습니다. 그러나 복원 스레드 수가 많을수록 더 많은 구성 요소를 병렬로 복원할 수 있으므로 복원 속도가 빨라집니다. 유효한 범위는 1에서 10 사이이고 기본값은 3입니다.
WhatIf	선택	System.Management.Automation.SwitchParameter	명령을 실행하는 대신에 명령의 효과를 설명하는 메시지를 표시합니다. 자세한 내용을 보려면 get-help about_commonparameters 명령을 입력하십시오.

입력 형식

반환 형식

Example

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

Restore-SPFarm -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -RestoreMethod new -ConfigurationOnly

이 예제에서는 \\file_server\share\Backup 디렉터리에 있는 백업 패키지의 구성 설정을 팜으로 복원합니다.

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

Restore-SPFarm -ShowTree -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -Item "Microsoft SharePoint Foundation Web Application" -Verbose

이 예제에서는 Microsoft SharePoint Foundation Web Application 노드 아래에 복원될 팜의 구성 요소를 표시하지만 실제로 복원하지는 않습니다.

---------------예제 3---------------

Restore-SPFarm -Directory C:\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef  -RestoreMethod overwrite -RestoreThreads 10 -Force

이 예제에서는 10개의 스레드를 사용하여 팜을 복원하고 overwrite 경고를 표시하지 않습니다.

다음을 통해 공유