Restore-SqlDatabase

모듈:

SqlServer Module

백업 또는 트랜잭션 로그 레코드에서 데이터베이스를 복원합니다.

구문

ByPath (기본값)

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-Path <String[]>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByName

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -ServerInstance <String[]>
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -InputObject <Server[]>
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByDBObject

Restore-SqlDatabase
    [-DatabaseObject] <Database>
    [[-BackupFile] <String[]>]
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Restore-SqlDatabase cmdlet은 SQL Server 데이터베이스에서 복원 작업을 수행합니다. 여기에는 전체 데이터베이스 복원, 트랜잭션 로그 복원 및 데이터베이스 파일 복원이 포함됩니다.

이 cmdlet은 Microsoft.SqlServer.Management.Smo.Restore 클래스를 모델로 합니다. 이 cmdlet의 매개 변수는 일반적으로 Smo.Restore 개체의 속성에 해당합니다.

예제

예제 1: 네트워크 공유의 백업 파일에서 데이터베이스 복원

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.bak"

이 명령은 파일 MainDB 에서 서버 인스턴스\\mainserver\databasebackup\MainDB.bak로 전체 데이터베이스 Computer\Instance 를 복원합니다.

예제 2: 데이터베이스 트랜잭션 로그 복원

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log

이 명령은 파일 MainDB 에서 서버 인스턴스\\mainserver\databasebackup\MainDB.trn로 데이터베이스 Computer\Instance 의 트랜잭션 로그를 복원합니다.

예제 3: 데이터베이스 복원 및 암호 프롬프트

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.bak" -Credential (Get-Credential "sa")

이 명령은 SQL 로그인을 사용하여 파일 MainDB 에서 서버 인스턴스\\mainserver\databasebackup\MainDB.bak로 전체 데이터베이스 Computer\Instance 를 sa 복원합니다. 이 명령은 인증을 완료하기 위한 암호를 묻는 메시지를 표시합니다.

예제 4: NORECOVERY 옵션을 사용하여 트랜잭션 로그 복원

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log -NoRecovery

이 명령은 파일 MainDB 에서 서버 인스턴스NORECOVERY로의 옵션을 사용하여 \\mainserver\databasebackup\MainDB.trn 데이터베이스 Computer\Instance 의 트랜잭션 로그를 복원합니다.

예제 5: 특정 시점까지 트랜잭션 로그 레코드 복원

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log -ToPointInTime "Sep 21, 2017 11:11 PM"

이 명령은 2017년 9월 21일 오후 11시 11분 MainDB 매개 변수에 전달된 날짜까지 데이터베이스 의 트랜잭션 로그를 복원합니다.

예제 6: 데이터베이스 복원 및 데이터 및 로그 파일 재배치

PS C:\> $RelocateData = New-Object Microsoft.SqlServer.Management.Smo.RelocateFile("MainDB_Data", "c:\MySQLServer\MainDB.mdf")
PS C:\> $RelocateLog = New-Object Microsoft.SqlServer.Management.Smo.RelocateFile("MainDB_Log", "c:\MySQLServer\MainDB.ldf")
PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RelocateFile @($RelocateData,$RelocateLog)

다음은 전체 데이터베이스 MainDB 를 서버 인스턴스 Computer\Instance로 복원하고 데이터 및 로그 파일을 재배치하는 예제입니다. 이동되는 각 파일에 대해 예제는 Microsoft.SqlServer.Management.Smo.RelocateFile 클래스의 인스턴스를 생성합니다. 각 생성자는 파일의 논리적 이름과 파일이 대상 서버에 배치될 실제 위치라는 두 개의 인수를 사용합니다. RelocateFile 개체는 Restore-SqlDatabase cmdlet의 RelocateFile 매개 변수에 전달됩니다.

예제 7: 테이프에서 데이터베이스 복원

PS C:\> $TapeDevice = New-Object Microsoft.Sqlserver.Management.Smo.BackupDeviceItem("\\.\tape0", "Tape")
PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupDevice $TapeDevice

다음은 서버 인스턴스MainDB로 명명된 테이프 디바이스에서 데이터베이스 \\.\tape0 를 복원하는 예제입니다Computer\Instance. 이 디바이스를 나타내기 위해 예제에서는 Microsoft.Sqlserver.Management.Smo.BackupDeviceItem 클래스의 인스턴스를 생성합니다. 생성자는 백업 디바이스의 이름과 백업 디바이스의 형식이라는 두 개의 인수를 사용합니다. 그런 다음 이 BackupDeviceItem 개체가 Restore-SqlDatabase cmdlet의 BackupDevice 매개 변수에 전달됩니다.

예제 8: Azure Blob Storage 서비스에서 데이터베이스 복원

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "https://mystorageaccountname.blob.core.windows.net/container/MyDB.bak" -SqlCredential "mySqlCredential"

이 명령은 Windows Azure Blob Storage 서비스의 파일에서 서버 인스턴스MainDB로 전체 데이터베이스 Computer\Instance 를 복원합니다.

예제 9: SQL2016 데이터베이스 백업 및 -AutoRelocateFile 사용하여 SQL2017 복원

PS C:\> Get-SqlDatabase -ServerInstance MYSERVER\SQL2016 -Database AdventureWorks | Backup-SqlDatabase -BackupFile 'C:\BAK2\AdventureWorks.bak'
PS C:\> $restore = Restore-SqlDatabase -ServerInstance MYSERVER\SQL2017 -Database AdventureWorks2016 -BackupFile 'C:\BAK2\AdventureWorks.bak' -AutoRelocateFile -PassThru
PS C:\> $db.RelocateFiles

LogicalFileName     PhysicalFileName
---------------     ----------------
AdventureWorks_Data C:\Program Files\Microsoft SQL Server\MSSQL14.SQL2017\MSSQL\DATA\AdventureWorks_Data.mdf
AdventureWorks_Log  C:\Program Files\Microsoft SQL Server\MSSQL14.SQL2017\MSSQL\DATA\AdventureWorks_Log.ldf

# You can see that the original PhysicalFileNames were indeed differet by running the followiong query:
PS C:\> Invoke-Sqlcmd -ServerInstance MYSERVER\SQL2016 -Query "RESTORE FILELISTONLY FROM  DISK = N'C:\BAK2\AdventureWorks.bak' WITH NOUNLOAD" | Select -Property LogicalName,PhysicalName

LogicalName         PhysicalName
-----------         ------------
AdventureWorks_Data C:\Program Files\Microsoft SQL Server\MSSQL13.SQL2016\MSSQL\DATA\AdventureWorks_Data.mdf
AdventureWorks_Log  C:\Program Files\Microsoft SQL Server\MSSQL13.SQL2016\MSSQL\DATA\AdventureWorks_Log.ldf

첫 번째 명령은 컴퓨터 MYSERVER에서 실행되는 SQL2016 인스턴스에서 데이터베이스 AdventureWorks의 백업을 수행합니다. 백업은 C:\BAK2 아래에 저장됩니다.

동일한 백업 파일은 두 번째 cmdlet에서 동일한 컴퓨터(MYSERVER)에서 실행되는 SQL2017 인스턴스에서 데이터베이스를 복원하는 데 사용됩니다. -AutoRelocate 스위치가 없으면 위의 두 테이블에 표시된 것처럼 물리적 파일이 다르기 때문에 cmdlet이 실패했습니다(또한 SQL2016 파일을 사용하고 SQL2017 액세스할 수 없을 가능성이 높습니다). -AutoRelocate를 사용하면 빌드하는 데 매우 지루한 인수인 -RelocationFile을 명시적으로 사용할 필요가 없습니다.

참고: SQL2016 인스턴스와 SQL2017 인스턴스 모두 C:\BAK2 폴더에 액세스할 수 있다고 가정합니다.

매개 변수

-AccessToken

사용자/암호 또는 Windows 인증 대신 SQL Server에 인증하는 데 사용되는 액세스 토큰입니다.

예를 들어 연결하거나 SQL Azure DB 사용하려면 SQL Azure Managed Instance 이 메서드를 Service PrincipalManaged Identity사용할 수 있습니다.

사용할 매개 변수는 토큰을 나타내는 문자열이거나 PSAccessToken 실행 Get-AzAccessToken -ResourceUrl https://database.windows.net하여 반환된 개체일 수 있습니다.

이 매개 변수는 모듈의 v22에서 새로 생성됩니다.

매개 변수 속성

형식:	PSObject
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-AutoRelocateFile

이 스위치를 지정하면 이러한 논리 파일이 RelocateFile으로 지정되지 않는 한 cmdlet은 백업의 모든 논리 파일을 자동으로 재배치합니다. DefaultFile 및 DefaultLog 서버는 파일을 재배치하는 데 사용됩니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-BackupDevice

백업이 저장되는 디바이스를 지정합니다. 이 매개 변수는 BackupFile 매개 변수와 함께 사용할 수 없습니다. 테이프 디바이스에 백업하는 경우 이 매개 변수를 사용합니다.

매개 변수 속성

형식:	BackupDeviceItem[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-BackupFile

백업 파일이 저장되는 위치 또는 위치를 지정합니다. 이 매개 변수는 선택 사항입니다. 지정하지 않으면 서버의 기본 백업 위치가 로그 복원의 이름 <database name>.trn 또는 <database name>.bak 다른 모든 유형의 복원에 대해 검색됩니다. 이 매개 변수는 BackupDevice 매개 변수와 함께 사용할 수 없습니다. Windows Azure Blob Storage 서비스(URL)에 백업하는 경우 이 매개 변수 또는 BackupDevice 매개 변수를 지정해야 합니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	2
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-BlockSize

백업에 대한 실제 블록 크기(바이트)를 지정합니다. 지원되는 크기는 512, 1024, 2048, 4096, 8192, 16384, 32768 및 65536(64KB) 바이트입니다. 기본값은 테이프 디바이스의 경우 65536이고 다른 모든 디바이스의 경우 512입니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-BufferCount

백업 작업에 사용되는 I/O 버퍼의 총 수를 지정합니다. 양수 정수를 지정할 수 있습니다. 버퍼에 대한 Sqlservr.exe 프로세스에 가상 주소 공간이 부족한 경우 메모리 부족 오류가 발생합니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Checksum

복원 작업 중에 체크섬 값이 계산되었음을 나타냅니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ClearSuspectPageTable

복원 작업 후에 주의 대상 페이지 테이블이 삭제됨을 나타냅니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	cf(cf)

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ConnectionTimeout

시간 제한 오류가 발생하기 전에 서버 연결을 대기할 시간(초)을 지정합니다. 시간 제한 값은 0에서 65534 사이의 정수여야 합니다. 0을 지정하면 연결 시도가 시간 초과되지 않습니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ByName

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ContinueAfterError

체크섬 오류가 발생할 때 작업이 계속되도록 나타냅니다. 설정하지 않으면 체크섬 오류가 발생한 후 작업이 실패합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Credential

이 작업을 수행할 수 있는 권한이 있는 SQL Server 로그인에 대한 자격 증명을 포함하는 PSCredential 개체를 지정합니다.

매개 변수 속성

형식:	PSCredential
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ByName

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Database

복원할 데이터베이스의 이름을 지정합니다. DatabaseObject 매개 변수와 함께 사용할 수 없습니다. 이 매개 변수를 사용하는 경우 Path, InputObject 또는 ServerInstance 매개 변수도 지정해야 합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ByPath

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ByName

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ByObject

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DatabaseFile

복원 작업의 대상이 되는 데이터베이스 파일을 지정합니다. RestoreAction 매개 변수가 Files 로 설정된 경우에만 사용됩니다. RestoreAction 매개 변수가 Files로 설정된 경우 DatabaseFileGroups 또는 DatabaseFiles 매개 변수도 지정해야 합니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DatabaseFileGroup

복원 작업의 대상이 되는 데이터베이스 파일 그룹을 지정합니다. RestoreAction 매개 변수가 File 로 설정된 경우에만 사용됩니다. RestoreAction 매개 변수가 Files로 설정된 경우 DatabaseFileGroups 또는 DatabaseFiles 매개 변수도 지정해야 합니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DatabaseObject

복원 작업에 대한 데이터베이스 개체를 지정합니다.

매개 변수 속성

형식:	Database
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ByDBObject

Position:	1
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Encrypt

SQL Server에 연결할 때 사용할 암호화 유형입니다.

이 값은 Encrypt Microsoft.Data.SqlClient 드라이버의 SqlConnection 개체에 있는 속성 SqlConnectionEncryptOption 에 매핑됩니다.

모듈의 v22에서 기본값은 Optional v21과의 호환성을 위한 것입니다. 모듈의 v23+에서 기본값은 기존 스크립트에 대한 호환성이 손상되는 변경을 만들 수 있는 '필수'입니다.

이 매개 변수는 모듈의 v22에서 새로 생성됩니다.

매개 변수 속성

형식:	String
Default value:	None
허용되는 값:	Mandatory, Optional, Strict
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-FileNumber

백업 매체에서 대상 백업 집합을 식별하는 데 사용되는 인덱스 번호를 지정합니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-HostNameInCertificate

SQL Server TLS/SSL 인증서의 유효성을 검사할 때 사용할 호스트 이름입니다. SQL Server 인스턴스가 Force Encryption을 사용하도록 설정되어 있고 호스트 이름/짧은 이름을 사용하여 인스턴스에 연결하려는 경우 이 매개 변수를 전달해야 합니다. 이 매개 변수를 생략하면 강제 암호화를 사용하도록 설정된 SQL Server 인스턴스에 연결하려면 FQDN(정규화된 도메인 이름)을 -ServerInstance 전달해야 합니다.

이 매개 변수는 모듈의 v22에서 새로 생성됩니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-InputObject

복원이 발생하는 SQL Server 인스턴스의 서버 개체를 지정합니다.

매개 변수 속성

형식:	Server[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ByObject

Position:	Named
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-KeepReplication

복제 구성이 유지됨을 나타냅니다. 설정하지 않으면 복제 구성이 복원 작업에서 무시됩니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-MaxTransferSize

백업 미디어와 SQL Server 인스턴스 간에 전송할 최대 바이트 수를 지정합니다. 가능한 값은 최대 4194304 바이트(4MB)까지 65536바이트(64KB)의 배수입니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-MediaName

미디어 집합을 식별하는 이름을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-NoRecovery

데이터베이스가 복원 상태로 복원됨을 나타냅니다. 롤백 작업이 발생하지 않으며 추가 백업을 복원할 수 있습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-NoRewind

복원이 완료될 때 테이프 드라이브가 끝 위치에 열려 있음을 나타냅니다. 설정하지 않으면 작업이 완료된 후 테이프가 되감습니다. 디스크 복원에는 적용되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Offset

복원할 페이지 주소를 지정합니다. RestoreAction이 OnlinePage로 설정된 경우에만 사용됩니다.

매개 변수 속성

형식:	Int64[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Partial

복원 작업이 부분 복원임을 나타냅니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PassThru

이 cmdlet은 복원 작업을 수행하는 데 사용되는 Smo.Backup 개체를 출력한다는 것을 나타냅니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Path

복원 작업을 실행할 SQL Server 인스턴스의 경로를 지정합니다. 이 매개 변수는 선택 사항입니다. 지정하지 않으면 현재 작업 위치가 사용됩니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ByPath

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-RelocateFile

Smo.Relocate 파일 개체의 목록을 지정합니다. 각 개체는 논리적 백업 파일 이름과 실제 파일 시스템 위치로 구성됩니다. 복원하면 복원된 데이터베이스가 대상 서버의 지정된 실제 위치로 이동합니다.

매개 변수 속성

형식:	RelocateFile[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ReplaceDatabase

데이터베이스의 새 이미지가 생성되었음을 나타냅니다. 이렇게 하면 이름이 같은 기존 데이터베이스를 덮어씁니다. 설정하지 않으면 해당 이름의 데이터베이스가 서버에 이미 있는 경우 복원 작업이 실패합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Restart

이 cmdlet이 부분적으로 완료된 복원 작업을 다시 시작했음을 나타냅니다. 설정하지 않으면 cmdlet은 백업 세트 시작 시 중단된 복원 작업을 다시 시작합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-RestoreAction

수행되는 복원 작업의 유형을 지정합니다. 유효한 값은 다음과 같습니다.

• 데이터베이스. 데이터베이스가 복원됩니다.
• 파일. 하나 이상의 데이터 파일이 복원됩니다. DatabaseFile 또는 DatabaseFileGroup 매개 변수를 지정해야 합니다.
• OnlinePage. 사용자가 데이터베이스를 계속 사용할 수 있도록 데이터 페이지가 온라인으로 복원됩니다.
• OnlineFiles. 데이터 파일은 사용자가 데이터베이스를 계속 사용할 수 있도록 온라인으로 복원됩니다. DatabaseFile 또는 DatabaseFileGroup 매개 변수를 지정해야 합니다.
• 로그. 트랜잭션 로그가 복원됩니다.

매개 변수 속성

형식:	RestoreActionType
Default value:	None
허용되는 값:	Database, Files, OnlinePage, OnlineFiles, Log
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-RestrictedUser

복원된 데이터베이스에 대한 액세스가 db_owner 고정 데이터베이스 역할 및 dbcreator 및 sysadmin 고정 서버 역할로 제한됨을 나타냅니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Script

이 cmdlet은 복원 작업을 수행하는 Transact-SQL 스크립트를 출력한다는 것을 나타냅니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ServerInstance

SQL Server 인스턴스의 이름을 지정합니다. 이 서버 인스턴스는 복원 작업의 대상이 됩니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ByName

Position:	Named
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-SqlCredential

인증 정보를 저장하는 SQL Server 자격 증명 개체를 지정합니다. Blob Storage 서비스에 백업하는 경우 이 매개 변수를 지정해야 합니다. 저장된 인증 정보에는 Storage 계정 이름 및 연결된 액세스 키 값이 포함됩니다. 디스크 또는 테이프에 대해 이 매개 변수를 지정하지 마세요.

매개 변수 속성

형식:	PSObject
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-StandbyFile

SQL Server 인스턴스에 대한 이미징 전략의 일부로 사용되는 실행 취소 파일의 이름을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-StopAtMarkAfterDate

StopAtMarkName 매개 변수에 지정된 표시 이름과 함께 복구 작업의 중지 지점을 결정하는 데 사용할 날짜를 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-StopAtMarkName

복구 작업을 중지할 표시된 트랜잭션을 지정합니다. 이는 StopAtMarkAfterDate 와 함께 사용하여 복구 작업의 중지점을 확인합니다. 복구된 데이터에는 표시가 포함된 트랜잭션이 포함됩니다. StopAtMarkAfterDate 값이 설정되지 않은 경우 지정된 이름의 첫 번째 표시에서 복구가 중지됩니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-StopBeforeMarkAfterDate

StopBeforeMarkName과 함께 복구 작업의 중지 지점을 결정하는 데 사용할 날짜를 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-StopBeforeMarkName

복구 작업을 중지하기 전에 표시된 트랜잭션을 지정합니다. 이는 StopBeforeMarkAfterDate 와 함께 사용하여 복구 작업의 중지 지점을 확인합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ToPointInTime

데이터베이스 로그 복원을 위한 엔드포인트를 지정합니다. 이는 RestoreAction 이 로그로 설정된 경우에만 적용됩니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-TrustServerCertificate

신뢰의 유효성을 검사하기 위해 인증서 체인을 건너뛰는 동안 채널이 암호화되는지 여부를 나타냅니다.

모듈의 v22에서 기본값은 $true v21과의 호환성을 위한 것입니다. 모듈의 v23+에서 기본값은 '$false'이며, 이로 인해 기존 스크립트에 대한 호환성이 손상되는 변경이 발생할 수 있습니다.

이 매개 변수는 모듈의 v22에서 새로 생성됩니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-UnloadTapeAfter

작업이 완료될 때 테이프 디바이스가 다시 해제되고 언로드됨을 나타냅니다. 설정하지 않으면 테이프 매체를 되감고 언로드하려고 시도하지 않습니다. 디스크 백업에는 적용되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	위스콘신

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server

SMO를 지정합니다. 복원 작업이 수행되는 SQL Server 인스턴스를 설명하는 서버 개체입니다.

System.String

관련 링크

• SQL 데이터베이스 백업 (Backup-SqlDatabase)