Restore-SPFarm

참조

모듈:: SharePointServer

적용 대상:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Syntax

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

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

Description

이 cmdlet에는 둘 이상의 매개 변수 집합이 포함됩니다. 한 매개 변수 집합의 매개 변수만 사용할 수 있으며 서로 다른 매개 변수 집합의 매개 변수를 결합할 수 없습니다. 매개 변수 세트를 사용하는 방법에 대한 자세한 내용은 Cmdlet 매개 변수 세트를 참조하세요.

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

SharePoint 제품용 Windows PowerShell에 대한 사용 권한 및 최신 정보는 SharePoint Server Cmdlets를 참조하세요.

예제

---------------예제 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 경고를 표시하지 않습니다.

매개 변수

-AssignmentCollection

올바른 삭제를 위해 개체를 관리합니다. SPWeb 또는 SPSite와 같은 개체를 사용하는 경우 많은 양의 메모리를 사용할 수 있으며, Windows PowerShell 스크립트에서 이러한 개체를 사용하려면 올바른 메모리 관리가 필요합니다. SPAssignment 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다.

Global 매개 변수가 사용되는 경우 모든 개체가 전역 저장소에 포함됩니다. 개체가 즉시 사용되지 않거나 Stop-SPAssignment 명령을 사용하여 삭제되지 않는 경우 메모리 부족 시나리오가 발생할 수 있습니다.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-BackupId

복원할 백업 패키지의 GUID를 지정합니다. 각 백업 패키지에는 연결된 고유한 GUID가 있습니다. cmdlet을 Get-SPBackupHistory 사용하여 백업 기록을 확인하여 GUID를 볼 수 있습니다. 이 매개 변수를 지정하지 않으면 디렉터리 매개 변수로 지정된 경로의 가장 최근 백업 패키지가 사용됩니다.

형식은 12345678-90ab-cdef-1234-567890abcdef 형식의 유효한 GUID여야 합니다.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConfigurationOnly

백업 패키지에서 설정만(데이터 제외) 복원하여 대상 팜의 개체에 적용하도록 지정합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

명령을 실행하기 전에 사용자에게 확인 메시지를 표시합니다. 자세한 내용을 확인하려면 다음 명령을 입력하세요. get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Directory

SharePoint Products에서 백업 패키지를 저장한 경로를 지정합니다. SQL Server 및 SharePoint 제품 인스턴스가 설치된 컴퓨터가 있는 경우 로컬 드라이브 경로를 사용할 수 있습니다. 기본 설치가 여기에 포함됩니다. 그러나 SQL Server 및 SharePoint 제품이 여러 컴퓨터에 설치된 경우 SQL SERVER 및 SharePoint 제품이 동일한 위치(예: \\computer_name \volume\Backup)에서 읽을 수 있도록 UNC(유니버설 명명 규칙) 공유 경로를 사용해야 합니다.

형식은 다음과 같은 형식의 유효한 경로 중 하나여야 합니다.

C:\folder_name
\\server_name\folder_name

spbr* 폴더가 자동으로 만들어집니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-FarmCredentials

복원되는 모든 구성 요소에 사용할 자격 증명을 지정합니다. 예를 들어 복원 중인 웹 애플리케이션에 대한 애플리케이션 풀 자격 증명입니다. 복원 중인 애플리케이션 풀이 팜에 이미 있는 경우 해당 애플리케이션 풀을 복원할 때 FarmCredentials 매개 변수에 지정된 자격 증명이 무시됩니다.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Force

덮어쓰기 복원 작업을 실행할 때 구성 요소를 덮어쓰게 된다고 경고하는 메시지를 표시하지 않습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Item

복원할 백업 패키지 부분을 나타냅니다. ShowTree 매개 변수를 통해 표시되는 전체 팜 경로 표기법을 사용할 수도 있고, 고유한 이름이 있는 경우 경로의 대상 구성 요소 이름을 사용할 수도 있습니다. 이름이 일치하는 항목이 여러 개 있으면 전체 경로를 제공해야 합니다. 항목이나 경로에 공백이 있으면 따옴표로 묶습니다. 이 매개 변수가 없으면 전체 백업 패키지가 복원됩니다.

형식은 다음과 같은 유효한 항목이어야 합니다.

Farm\Microsoft SharePoint Foundation Web Application\SharePoint - 80

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-NewDatabaseServer

유효한 SQL 데이터베이스 서버 이름을 지정합니다. 지정하면 복원 작업 내의 모든 데이터베이스에 대한 기본 데이터베이스 서버 이름으로 사용됩니다.

이 매개 변수는 새 매개 변수로 복원하는 경우에만 유효합니다. 복원을 덮어쓰는 것은 유효하지 않습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Percentage

복원 작업에 대한 진행률 업데이트를 해당 백분율의 증분 방식으로 표시하도록 요청합니다. 예를 들어 값 5 를 지정하면 5%가 완료될 때마다 복원 진행률 업데이트가 표시되고, 값 10 을 지정하면 10%가 완료될 때마다 복원 진행률 업데이트가 표시됩니다.

참고: -Verbose 매개 변수를 지정하면 출력에만 진행률이 표시됩니다. 그렇지 않은 경우 복원 로그 파일에서 진행률을 확인할 수 있습니다.

이 백분율은 정확한 수치가 아니며, 실제 진행률 업데이트는 요청된 값보다 작거나 클 수 있습니다.

데이터베이스가 매우 큰 경우 값 1 을 사용하는 것이 좋습니다.

형식은 1 에서 100 사이의 정수 값이어야 합니다.

기본값은 5입니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RestoreMethod

수행할 복원 방법을 지정합니다.

유효한 값은 다음과 같습니다.

새로운; 콘텐츠를 복원할 새 위치를 지정하며 다른 팜으로 복원할 때 사용됩니다. 새 설정을 지정하는 추가 프롬프트가 표시됩니다.
덮어쓸; 콘텐츠 및 설정을 원래 위치로 복원하고 백업된 동일한 팜으로 복원할 때 사용됩니다. Overwrite 매개 변수를 사용하는 경우 확인 프롬프트가 표시됩니다. 확인 프롬프트를 표시하지 않으려면 Force 매개 변수를 사용합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RestoreThreads

복원하는 동안 사용할 스레드 수입니다.

복원 스레드 수가 작을수록 복원 로그를 이해하기가 더 쉽습니다. 그러나 복원 스레드 수가 많을수록 더 많은 구성 요소를 병렬로 복원할 수 있으므로 복원 속도가 빨라집니다.

유효한 범위는 1에서 10 사이입니다. 기본값은 3입니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ShowTree

cmdlet에 전달 Restore-SPFarm 된 다른 매개 변수, 즉 Item 및 ConfigurationOnly 매개 변수를 기반으로 팜에서 복원할 개체를 표시합니다. cmdlet에 전달된 Restore-SPFarm 다른 매개 변수를 기반으로 복원에서 제외되는 항목 앞에 별표(*)가 표시됩니다. 복원할 수 없는 항목은 대괄호([ ])로 묶입니다. ShowTree 매개 변수가 있는 경우 복원 작업이 수행되지 않습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

명령을 실행하는 대신에 명령의 효과를 설명하는 메시지를 표시합니다. 자세한 내용을 확인하려면 다음 명령을 입력하세요. get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

다음을 통해 공유