Backup-SqlDatabase

참조

모듈:: SQLServer

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

Syntax

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>]
      [-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>]
      [-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>]
      [-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>]
      [-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>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

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

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

이 cmdlet은 Microsoft.SqlServer.Management.Smo.Backup 클래스 다음에 모델링됩니다.

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

서버 instance 경로 및 데이터베이스 이름으로 데이터베이스를 백업하려면 Path 매개 변수에서 서버 instance 경로를 지정하고 Database 매개 변수에서 데이터베이스 이름을 지정합니다.

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

서버 instance 및 데이터베이스 이름으로 데이터베이스를 백업하려면 ServerInstance 매개 변수에 서버 instance 지정하고 Database 매개 변수에서 데이터베이스 이름을 지정합니다.

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'instance 서버의 기본 백업 위치에 만듭니다. 백업 파일의 이름은 'MainDB.bak'입니다.

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

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

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

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

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

이 명령은 'MainDB' 데이터베이스의 트랜잭션 로그를 'Computer\Instance'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: 서버 instance 모든 데이터베이스 백업

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

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

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

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"에 instance 서버의 각 데이터베이스에 대한 전체 백업을 만듭니다. 백업 파일의 이름은 <데이터베이스 이름>.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

이 명령은 'Computer\Instance'를 instance 서버의 기본 백업 위치에 데이터베이스 'MainDB'의 차등 백업을 만듭니다. 백업 파일의 이름은 "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

이 명령은 데이터베이스 MainDB의 전체 백업을 테이프 디바이스 "\\.\tape0"에 만듭니다. 이 디바이스를 나타내기 위해 명령은 Microsoft.Sqlserver.Management.Smo.BackupDeviceItem 개체의 instance 생성합니다. 생성자는 백업 디바이스의 이름과 백업 디바이스의 유형이라는 두 개의 인수를 사용합니다. 이 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"

이 명령은 Windows Azure Blob Storage 서비스에 대한 데이터베이스 MainDB의 전체 백업을 만듭니다. 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'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 인증하는 데 사용되는 액세스 토큰입니다.

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

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

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupAction

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

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

Type:	BackupActionType
Accepted values:	Database, Files, Log
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupContainer

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupDevice

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

Type:	BackupDeviceItem[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupFile

백업의 위치 및 파일 이름을 지정합니다. 선택적 매개 변수입니다. 지정하지 않으면 백업은 전체 및 파일 백업에 대한 databasename.bak 이름 아래 서버의 기본 백업 위치에 저장되거나 로그 백업의 경우 databasename.trn에 저장됩니다. 이 매개 변수는 BackupDevice 또는 BackupContainer 매개 변수와 함께 사용할 수 없습니다.

Type:	String[]
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupSetDescription

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupSetName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BlockSize

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BufferCount

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Checksum

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CompressionOption

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

Type:	BackupCompressionOptions
Accepted values:	Default, On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionTimeout

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinueAfterError

체크섬 오류가 발생할 때 작업이 계속됨을 나타냅니다. 설정되지 않은 경우 체크섬 오류 후 작업이 실패합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CopyOnly

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseFile

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseFileGroup

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseObject

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

Type:	Database
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Encrypt

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

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

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

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionOption

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

Type:	BackupEncryptionOptions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExpirationDate

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

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FormatMedia

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameInCertificate

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

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Incremental

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Initialize

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	Server[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-LogTruncationType

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

-- TruncateOnly -- NoTruncate -- Truncate

기본값은 Truncate입니다.

Type:	BackupTruncateLogType
Accepted values:	TruncateOnly, NoTruncate, Truncate
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxTransferSize

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaDescription

백업 집합이 포함된 매체에 대한 설명을 지정합니다. 이 매개 변수는 선택적 요소입니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MirrorDevices

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

Type:	BackupDeviceList[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRecovery

로그의 테일 엔드가 백업되지 않음을 나타냅니다. 데이터베이스가 복원되면 복원 중인 상태로 유지됩니다. 설정되지 않은 경우는 비상 로그가 백업됩니다. BackupAction 매개 변수가 Log로 설정된 경우에만 적용됩니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRewind

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Restart

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RetainDays

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerInstance

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

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SkipTapeHeader

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SqlCredential

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

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StatementTimeout

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

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

Type:	Int32
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustServerCertificate

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

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

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UndoFileName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnloadTapeAfter

작업이 완료될 때 테이프 디바이스가 다시 해제되고 언로드됨을 나타냅니다. 설정되지 않은 경우 테이프 미디어를 되감고 언로드하지 않습니다. 디스크 또는 URL 백업에는 적용되지 않습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet이 실행되지 않습니다. cmdlet이 실행될 경우 어떤 일이 발생하는지 표시합니다. cmdlet은 실행되지 않습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

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

System.String[]

출력

System.Object

Restore-SqlDatabase

Backup-SqlDatabase

Syntax

Description

예제

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

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

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

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

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

예제 6: 서버 instance 모든 데이터베이스 백업

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

예제 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

-Restart

-RetainDays

-Script

-ServerInstance

-SkipTapeHeader

-SqlCredential

-StatementTimeout

-TrustServerCertificate

-UndoFileName

-UnloadTapeAfter

-WhatIf

입력

출력

관련 링크

추가 리소스