Backup-SqlDatabase

構文

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>]

説明

Backup-SqlDatabase コマンドレットは、SQL Server データベースに対してバックアップ操作を実行します。

これには、データベースの完全バックアップ、トランザクション ログ バックアップ、データベース ファイルのバックアップが含まれます。

このコマンドレットは、Microsoft.SqlServer.Management.Smo.Backup クラスの後にモデル化されています。

このクラスのパラメーターは、通常、その Smo オブジェクトのプロパティに対応します。

サーバー インスタンスのパスとデータベース名でデータベースをバックアップするには、Path パラメーターにサーバー インスタンス パスを指定し、データベース パラメーターにデータベース名を指定します。

Smo.Server オブジェクトとデータベース名を使用してデータベースをバックアップするには、InputObject パラメーターに Smo.Server オブジェクトを直接指定するか、パイプライン演算子を使用して指定し、データベース パラメーターにデータベース名を指定します。

サーバー インスタンスとデータベース名でデータベースをバックアップするには、ServerInstance パラメーターにサーバー インスタンスを指定し、データベース パラメーターにデータベース名を指定します。

Smo.Database オブジェクトを使用してデータベースをバックアップするには、DatabaseObject パラメーターに Smo.Database オブジェクトを直接指定するか、パイプライン演算子を使用して指定します。

既定では、このコマンドレットはデータベースの完全バックアップを実行します。

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

このコマンドにより、データベース MainDB のテープ デバイス "\\.\tape0" への完全バックアップが作成されます。 このデバイスを表すために、このコマンドは Microsoft.Sqlserver.Management.Smo.BackupDeviceItem オブジェクトのインスタンスを構築します。 コンストラクターは、バックアップ デバイスの名前とバックアップ デバイスの種類という 2 つの引数を受け取ります。 この BackupDeviceItem オブジェクトは、Backup-SqlDatabase コマンドレットの BackupDevice パラメーターに渡されます。

例 11: データベースを Azure Blob Storage サービスにバックアップする

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

このコマンドを実行すると、データベース 'MainDB' の完全バックアップが Windows Azure Blob Storage サービスに作成されます。 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

-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

入力

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

SMO を指定します。バックアップ操作が行われる SQL Server のインスタンスを参照するサーバー オブジェクト。

System.String[]

出力

System.Object

関連リンク

• Restore-SqlDatabase