Backup-SqlDatabase

참조

모듈:: SQLServer

SQL Server 데이터베이스 개체를 백업합니다.

구문

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-Database] <String>
      [-Path <String[]>]
      [[-BackupFile] <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>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-DatabaseObject] <Database>
      [[-BackupFile] <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>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-Database] <String>
      -ServerInstance <String[]>
      [-Credential <PSCredential>]
      [-ConnectionTimeout <Int32>]
      [[-BackupFile] <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>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-Database] <String>
      -InputObject <Server[]>
      [[-BackupFile] <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>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [[-BackupFile] <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>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Backup-SqlDatabase cmdlet은 SQL Server 데이터베이스에서 백업 작업을 수행합니다.

여기에는 전체 데이터베이스 백업, 트랜잭션 로그 백업 및 데이터베이스 파일 백업이 포함됩니다.

이 cmdlet은 Microsoft.SqlServer.Management.Smo.Backup 클래스를 모델로 합니다.

이 클래스의 매개 변수는 일반적으로 해당 Smo 개체의 속성에 해당합니다.

서버 인스턴스 경로 및 데이터베이스 이름으로 데이터베이스를 백업하려면 Path 매개 변수의 서버 인스턴스 경로와 데이터베이스 매개 변수의 데이터베이스 이름을 지정합니다.

Smo.Server 개체 및 데이터베이스 이름을 사용하여 데이터베이스를 백업하려면 InputObject 매개 변수에서 직접 또는 파이프라인 연산자를 사용하여 Smo.Server 개체를 지정하고 Database 매개 변수의 데이터베이스 이름을 지정합니다.

서버 인스턴스 및 데이터베이스 이름으로 데이터베이스를 백업하려면 ServerInstance 매개 변수의 서버 인스턴스와 데이터베이스 매개 변수의 데이터베이스 이름을 지정합니다.

Smo.Database 개체를 사용하여 데이터베이스를 백업하려면 직접 또는 파이프라인 연산자를 사용하여 DatabaseObject 매개 변수에 Smo.Database 개체를 지정합니다.

기본적으로 이 cmdlet은 전체 데이터베이스 백업을 수행합니다.

BackupAction 매개 변수를 사용하여 백업 유형을 설정합니다.

기본적으로 백업 파일은 전체 및/또는 파일 백업의 이름 databasename.bak 아래의 기본 서버 백업 위치와 로그 백업의 이름 databasename.trn 아래에 저장됩니다. 다른 파일 이름을 지정하려면 BackupFile 매개 변수를 사용합니다.

백업 파일 위치를 지정하고 자동 생성된 파일 이름을 사용하려면 BackupContainer 매개 변수를 사용하여 위치를 지정합니다.

예제

예제 1: 전체 데이터베이스 백업

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB"

이 명령은 'MainDB'라는 데이터베이스의 전체 데이터베이스 백업을 서버 인스턴스 'Computer\Instance'의 기본 백업 위치에 만듭니다. 백업 파일의 이름은 'MainDB.bak'입니다.

예제 2: 위치에 따라 데이터베이스 백업

PS C:\> Set-Location "SQLSERVER:\SQL\Computer\Instance" 
PS SQLSERVER:\SQL\Computer\Instance> Backup-SqlDatabase -Database "MainDB"

이 명령은 'MainDB' 데이터베이스의 전체 데이터베이스 백업을 서버 인스턴스 'Computer\Instance'의 기본 백업 위치에 만듭니다. 현재 작업 디렉터리를 사용하여 백업이 발생하는 서버 인스턴스를 확인합니다.

예제 3: 트랜잭션 로그 백업

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Log

이 명령은 'MainDB' 데이터베이스의 트랜잭션 로그를 서버 인스턴스 'Computer\Instance'의 기본 백업 위치에 백업합니다. 백업 파일의 이름은 'MainDB.trn'입니다.

예제 4: 데이터베이스 백업 및 자격 증명 확인

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Credential (Get-Credential "sa")

이 명령은 'sa' SQL Server 로그인을 사용하여 데이터베이스 'MainDB'의 전체 데이터베이스 백업을 만듭니다. 이 명령은 인증을 완료하기 위한 암호를 묻는 메시지를 표시합니다.

예제 5: 네트워크 파일 공유에 데이터베이스 백업

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

이 명령은 데이터베이스 'MainDB'의 전체 데이터베이스 백업을 "\\mainserver\databasebackup\MainDB.bak" 파일에 만듭니다.

예제 6: 서버 인스턴스의 모든 데이터베이스 백업

PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase

이 명령은 서버 인스턴스 'Computer\Instance'의 모든 데이터베이스를 기본 백업 위치로 백업합니다. 백업 파일의 이름은 데이터베이스 이름>.bak <.

예제 7: 서버 인스턴스의 모든 데이터베이스를 네트워크 파일 공유에 백업

PS C:\> Set-Location "SQLSERVER:\SQL\Computer\Instance\Databases"
PS SQLSERVER:\SQL\Computer\Instance\Databases> foreach ($database in (Get-ChildItem)) {
     $dbName = $database.Name
     Backup-SqlDatabase -Database $dbName -BackupFile "\\mainserver\databasebackup\$dbName.bak" }

이 명령은 서버 인스턴스 'Computer\Instance'의 각 데이터베이스에 대한 전체 백업을 공유 "\\mainserver\databasebackup"에 만듭니다. 백업 파일의 이름은 데이터베이스 이름>.bak <.

예제 8: 보조 파일 그룹의 모든 파일 백업

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Files -DatabaseFileGroup "FileGroupJan","FileGroupFeb"

이 명령은 보조 파일 그룹 'FileGroupJan' 및 'FileGroupFeb'에 있는 모든 파일의 전체 파일 백업을 만듭니다.

예제 9: 차등 백업 만들기

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Incremental

이 명령은 'MainDB' 데이터베이스의 차등 백업을 서버 인스턴스 'Computer\Instance'의 기본 백업 위치에 만듭니다. 백업 파일의 이름은 "MainDB.bak"입니다.

예제 10: 테이프 드라이브에 백업 만들기

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

이 명령은 테이프 디바이스 "\\.\tape0"에 대한 데이터베이스 MainDB의 전체 백업을 만듭니다. 이 디바이스를 나타내기 위해 명령은 Microsoft.Sqlserver.Management.Smo.BackupDeviceItem 개체의 인스턴스를 생성합니다. 생성자는 백업 디바이스의 이름과 백업 디바이스의 형식이라는 두 개의 인수를 사용합니다. 이 BackupDeviceItem 개체는 Backup-SqlDatabase cmdlet의 BackupDevice 매개 변수에 전달됩니다.

예제 11: Azure Blob Storage 서비스에 데이터베이스 백업

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"

이 명령은 Windows Azure Blob Storage 서비스에 대한 데이터베이스 'MainDB'의 전체 백업을 만듭니다. BackupContainer를 사용하여 Windows Azure Blob 컨테이너의 위치(URL)를 지정합니다. 백업 파일의 이름이 자동으로 생성됩니다. SqlCredential 매개 변수는 인증 정보를 저장하는 SQL Server 자격 증명의 이름을 지정하는 데 사용됩니다.

예제 12: Azure Blob Storage 서비스에 데이터베이스 백업 및 파일 이름 지정

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainyDB" -BackupFile "https://storageaccountname.blob.core.windows.net/containername/MainDB.bak" -SqlCredential "SQLCredentialName"

이 명령은 데이터베이스 MainDB의 전체 백업을 Windows Azure Blob Storage 서비스에 만듭니다. BackupFile 매개 변수를 사용하여 위치(URL) 및 백업 파일 이름을 지정합니다. SqlCredential 매개 변수는 SQL Server 자격 증명의 이름을 지정하는 데 사용됩니다.

예제 13: 모든 데이터베이스를 Azure Blob Storage 서비스에 백업

PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"

이 명령은 BackupContainer 매개 변수를 사용하여 서버 인스턴스 'Computer\Instance'의 모든 데이터베이스를 Windows Azure Blob Storage 서비스 위치에 백업합니다. 백업 파일 이름이 자동으로 생성됩니다.

예제 14: 암호화된 백업 만들기

PS C:\> $EncryptionOption = New-SqlBackupEncryptionOption -Algorithm Aes256 -EncryptorType ServerCertificate -EncryptorName "BackupCert"
PS C:\> Backup-SqlDatabase -ServerInstance "." -Database "MainDB" -BackupFile "MainDB.bak" -CompressionOption On -EncryptionOption $EncryptionOption

이 예제에서는 암호화 옵션을 만들고 Backup-SqlDatabase 매개 변수 값으로 사용하여 암호화된 백업을 만듭니다.

매개 변수

-AccessToken

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

예를 들어 Service Principal 또는 Managed Identity사용하여 SQL Azure DB 연결하고 SQL Azure Managed Instance 데 사용할 수 있습니다.

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

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

형식:	PSObject
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BackupAction

수행할 백업 작업의 유형을 지정합니다. 유효한 값은 다음과 같습니다.

데이터베이스. 데이터베이스의 모든 데이터 파일을 백업합니다.
파일. DatabaseFile 또는 DatabaseFileGroup 매개 변수에 지정된 데이터 파일을 백업합니다.
로그. 트랜잭션 로그를 백업합니다.

형식:	BackupActionType
허용되는 값:	Database, Files, Log
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BackupContainer

cmdlet이 백업을 저장하는 폴더 또는 위치를 지정합니다. 디스크의 폴더 또는 Azure Blob 컨테이너의 URL일 수 있습니다. 이 매개 변수는 지정된 인스턴스에서 여러 데이터베이스를 백업할 때 유용할 수 있습니다. 이 매개 변수는 BackupDevice 매개 변수와 함께 사용할 수 없습니다. BackupContainer 매개 변수는 BackupFile 매개 변수와 함께 사용할 수 없습니다.

위치를 지정하는 데 사용되는 경로는 슬래시(/)로 끝나야 합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BackupDevice

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

형식:	BackupDeviceItem[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BackupFile

백업의 위치 및 파일 이름을 지정합니다.

선택적 매개 변수입니다.

지정하지 않으면 백업은 전체 및 파일 백업에 대한 이름 databasename.bak 서버의 기본 백업 위치 또는 로그 백업에 대한 databasename.trn에 저장됩니다.

여러 파일에 백업하는 경우 파일 이름을 쉼표로 구분합니다(예: -BackupFile C:\Backups\databasename2.bak,C:\Backups\databasename2.bak

이 매개 변수는 -BackupDevice 또는 -BackupContainer 매개 변수와 함께 사용할 수 없습니다.

형식:	String[]
Position:	2
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BackupSetDescription

백업 집합에 대한 설명을 지정합니다. 이 매개 변수는 선택 사항입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BackupSetName

백업 집합의 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BlockSize

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

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BufferCount

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

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Checksum

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CompressionOption

백업 작업에 대한 압축 옵션을 지정합니다.

형식:	BackupCompressionOptions
허용되는 값:	Default, On, Off
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

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

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ConnectionTimeout

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

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ContinueAfterError

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CopyOnly

백업이 복사 전용 백업임을 나타냅니다. 복사 전용 백업은 정기적으로 예약된 기존 백업의 일반 시퀀스에 영향을 주지 않습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Credential

이 작업을 수행할 수 있는 권한이 있는 SQL Server 로그인에 대한 자격 증명을 포함하는 PSCredential 개체를 지정합니다. SQL Server 외부의 리소스에 액세스할 때 SQL Server에서 내부적으로 인증 정보를 저장하는 데 사용되는 SQL 자격 증명 개체가 아닙니다.

형식:	PSCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Database

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

형식:	String
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DatabaseFile

백업할 데이터베이스 파일을 하나 이상 지정합니다. 이 매개 변수는 BackupAction이 Files로 설정된 경우에만 사용됩니다. BackupAction이 Files로 설정된 경우 DatabaseFileGroups 또는 DatabaseFiles 매개 변수를 지정해야 합니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DatabaseFileGroup

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

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DatabaseObject

백업 작업의 데이터베이스 개체를 지정합니다.

형식:	Database
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Encrypt

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

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

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

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

형식:	String
허용되는 값:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EncryptionOption

백업 작업에 대한 암호화 옵션을 지정합니다.

형식:	BackupEncryptionOptions
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ExpirationDate

백업 세트가 만료되고 백업 데이터가 더 이상 유효한 것으로 간주되지 않는 날짜와 시간을 지정합니다. 디스크 또는 테이프 디바이스에 저장된 백업 데이터에만 사용할 수 있습니다. 만료 날짜보다 오래된 백업 세트는 이후 백업에서 덮어쓸 수 있습니다.

형식:	DateTime
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FormatMedia

테이프가 백업 작업의 첫 번째 단계로 포맷되었음을 나타냅니다. 디스크 백업에는 적용되지 않습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-HostNameInCertificate

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

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Incremental

차등 백업이 수행됨을 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Initialize

백업 작업과 연결된 디바이스가 초기화되었음을 나타냅니다. 이렇게 하면 미디어의 기존 백업 집합을 덮어쓰고 이 백업을 미디어의 첫 번째 백업 세트로 만듭니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-InputObject

백업 위치에 대한 서버 개체를 지정합니다.

형식:	Server[]
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-LogTruncationType

로그 백업에 대한 잘림 동작을 지정합니다. 유효한 값은 다음과 같습니다.

-- TruncateOnly -- NoTruncate -- Truncate

기본값은 Truncate입니다.

형식:	BackupTruncateLogType
허용되는 값:	TruncateOnly, NoTruncate, Truncate
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MaxTransferSize

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

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MediaDescription

백업 세트가 포함된 매체에 대한 설명을 지정합니다. 이 매개 변수는 선택 사항입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MediaName

미디어 세트를 식별하는 데 사용되는 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MirrorDevices

미러된 백업에서 사용하는 BackupDeviceList 개체의 배열을 지정합니다.

형식:	BackupDeviceList[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoRecovery

로그의 비상 끝이 백업되지 않음을 나타냅니다. 복원되면 데이터베이스가 복원 중 상태입니다. 설정하지 않으면 로그의 비상 끝이 백업됩니다. BackupAction 매개 변수가 Log로 설정된 경우에만 적용됩니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoRewind

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PassThru

cmdlet이 백업을 수행한 Smo.Backup 개체를 출력한다는 것을 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Path

백업 작업을 실행할 SQL Server 인스턴스의 경로를 지정합니다. 선택적 매개 변수입니다. 지정하지 않으면 이 매개 변수의 값은 기본적으로 현재 작업 위치로 설정됩니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ProgressAction

powerShell이 스크립트, cmdlet 또는 공급자(예: Write-Progress cmdlet에서 생성된 진행률 표시줄)에 의해 생성된 진행률 업데이트에 응답하는 방법을 결정합니다. Write-Progress cmdlet은 명령의 상태를 표시하는 진행률 표시줄을 만듭니다.

형식:	ActionPreference
별칭:	proga
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Restart

cmdlet이 부분적으로 완료된 백업 작업을 계속 처리하고 있음을 나타냅니다. 설정하지 않으면 cmdlet은 백업 세트 시작 시 중단된 백업 작업을 다시 시작합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RetainDays

백업 집합을 덮어쓰기 전에 경과해야 하는 일 수를 지정합니다. 디스크 또는 테이프 디바이스에 저장된 백업 데이터에만 사용할 수 있습니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Script

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ServerInstance

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

형식:	String[]
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-SkipTapeHeader

테이프 헤더를 읽지 않음을 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SqlCredential

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

형식:	PSObject
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-StatementTimeout

백업 작업의 시간 제한(초)을 설정합니다.

값이 0이거나 StatementTimeout 매개 변수를 지정하지 않으면 복원 작업이 시간 초과되지 않습니다.

형식:	Int32
Position:	Named
Default value:	0
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-TrustServerCertificate

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

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

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UndoFileName

복구 중에 롤백되는 커밋되지 않은 트랜잭션을 저장하는 데 사용되는 실행 취소 파일의 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UnloadTapeAfter

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

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

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

SMO를 지정합니다. 백업 작업이 수행되는 SQL Server 인스턴스를 참조하는 서버 개체입니다.

System.String[]

출력

System.Object

Restore-SqlDatabase

다음을 통해 공유

Backup-SqlDatabase

구문

Description

예제

예제 1: 전체 데이터베이스 백업

예제 2: 위치에 따라 데이터베이스 백업

예제 3: 트랜잭션 로그 백업

예제 4: 데이터베이스 백업 및 자격 증명 확인

예제 5: 네트워크 파일 공유에 데이터베이스 백업

예제 6: 서버 인스턴스의 모든 데이터베이스 백업

예제 7: 서버 인스턴스의 모든 데이터베이스를 네트워크 파일 공유에 백업

예제 8: 보조 파일 그룹의 모든 파일 백업

예제 9: 차등 백업 만들기

예제 10: 테이프 드라이브에 백업 만들기

예제 11: Azure Blob Storage 서비스에 데이터베이스 백업

예제 12: Azure Blob Storage 서비스에 데이터베이스 백업 및 파일 이름 지정

예제 13: 모든 데이터베이스를 Azure Blob Storage 서비스에 백업

예제 14: 암호화된 백업 만들기

매개 변수

-AccessToken

-BackupAction

-BackupContainer

-BackupDevice

-BackupFile

-BackupSetDescription

-BackupSetName

-BlockSize

-BufferCount

-Checksum

-CompressionOption

-Confirm

-ConnectionTimeout

-ContinueAfterError

-CopyOnly

-Credential

-Database

-DatabaseFile

-DatabaseFileGroup

-DatabaseObject

-Encrypt

-EncryptionOption

-ExpirationDate

-FormatMedia

-HostNameInCertificate

-Incremental

-Initialize

-InputObject

-LogTruncationType

-MaxTransferSize

-MediaDescription

-MediaName

-MirrorDevices

-NoRecovery

-NoRewind

-PassThru

-Path

-ProgressAction

-Restart

-RetainDays

-Script

-ServerInstance

-SkipTapeHeader

-SqlCredential

-StatementTimeout

-TrustServerCertificate

-UndoFileName

-UnloadTapeAfter

-WhatIf

입력

출력

관련 링크

피드백

추가 리소스