Restore-SPFarm
적용 대상: 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:\*폴더_이름* - \\*서버_이름*\폴더_이름 ![]()
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 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다. ![]()
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
경고를 표시하지 않습니다.
See Also
Reference
Backup-SPFarm
Backup-SPConfigurationDatabase
Get-SPBackupHistory