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

説明

Backup-SqlDatabase コマンドレットにより、SQL Server データベースでバックアップ操作が実行されます。

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

このコマンドレットは、Microsoft.SqlServer.Management.Smo.Backup クラスを基に作成されています。

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

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

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

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

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

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

BackupAction パラメーターを使用して、バックアップの種類を設定します。

既定では、バックアップファイルは、完全バックアップまたはファイルバックアップのdatabasename.bak名の下の既定のサーバーバックアップの場所に格納され、ログバックアップの場合は databasename.trn という名前で格納されます。別のファイル名を指定するには、BackupFile パラメーターを使用します。

バックアップファイルの場所を指定し、自動生成されたファイル名を使用するには、BackupContainer パラメーターを使用して場所を指定します。

例

例 1: データベース全体をバックアップする

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

このコマンドは、サーバーインスタンス 'Computer\Instance' の既定のバックアップ場所に 'MainDB' という名前のデータベースの完全なデータベースバックアップを作成します。バックアップファイルの名前は '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) を指定します。バックアップファイルの名前は自動生成されます。認証情報を格納する SQL Server 資格情報の名前を指定するには、SqlCredential パラメーターを使用します。

例 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) とバックアップファイル名を指定します。 SQL Server 資格情報の名前を指定するには、SqlCredential パラメーターを使用します。

例 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の認証に使用されるアクセストークン。

これは、たとえば、または Managed Identityに接続SQL Azure DBして SQL Azure Managed Instance 使用するために使用Service Principalできます。

使用するパラメーターには、を実行Get-AzAccessToken -ResourceUrl https://database.windows.netして返されるトークンまたはオブジェクトをPSAccessToken表す文字列を指定できます。

このパラメーターは、モジュールの 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

コマンドレットがバックアップを格納するフォルダーまたは場所を指定します。ディスク上のフォルダー、または 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 (64 KB) バイトです。既定値は、テープデバイスの場合は 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

コマンドレットを実行する前に、確認を求めるメッセージが表示されます。コマンドレットを実行する前に、確認を求めるメッセージが表示されます。

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

-ConnectionTimeout

タイムアウトエラーが発生するまでのサーバー接続を待機する秒数を指定します。タイムアウト値には、0 ～ 65,534 の範囲の整数値を指定する必要があります。 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

バックアップする 1 つ以上のデータベースファイルを指定します。このパラメーターは、BackupAction が [ファイル] に設定されている場合にのみ使用されます。 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 では、既定値は Optional (v21 との互換性のために) です。モジュールの 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 インスタンスで Force Encryption が有効になっており、hostname/shortname を使用してインスタンスに接続する場合は、このパラメーターを渡す必要があります。このパラメーターを省略した場合、強制暗号化が有効になっているSQL Server インスタンスに接続するには、完全修飾ドメイン名 (FQDN) を -ServerInstance に渡す必要があります。

このパラメーターは、モジュールの 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 のインスタンスの間で転送される最大バイト数を指定します。指定できる値は、最大4194304 バイト (4 MB) の 65536 バイト (64 KB) の倍数です。

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

コマンドレットが、バックアップを実行した Smo.Backup オブジェクトを出力することを示します。

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

-Path

バックアップ操作を実行するSQL Serverのインスタンスへのパスを指定します。これは省略可能なパラメーターです。このパラメーターの値を指定しない場合、既定では、現在の場所に設定されます。

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

-Restart

コマンドレットが部分的に完了したバックアップ操作の処理を続行することを示します。設定されていない場合、コマンドレットは、バックアップセットの先頭で中断されたバックアップ操作を再起動します。

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

このコマンドレットが、バックアップ操作を実行する Transact-SQL スクリプトを出力することを示します。

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

-ServerInstance

SQL Server インスタンスの名前を指定します。このサーバーインスタンスが、バックアップ操作の対象となります。

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 では、既定値は $true (v21 との互換性のために) です。モジュールの 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

コマンドレットの実行時に発生する内容を示します。コマンドレットは実行されません。コマンドレットが実行された場合の動作を示します。このコマンドレットは実行されません。

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のインスタンスを参照するサーバーオブジェクト。

System.String[]

出力

System.Object

Restore-SqlDatabase

Backup-SqlDatabase

構文

説明

例

例 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

-Restart

-RetainDays

-Script

-ServerInstance

-SkipTapeHeader

-SqlCredential

-StatementTimeout

-TrustServerCertificate

-UndoFileName

-UnloadTapeAfter

-WhatIf

入力

出力

関連リンク

その他のリソース

例 3: トランザクションログをバックアップする

例 5: データベースをネットワークファイル共有にバックアップする

例 6: サーバーインスタンス内のすべてのデータベースをバックアップする

例 7: サーバーインスタンス内のすべてのデータベースをネットワークファイル共有にバックアップする

例 8: セカンダリファイルグループ内のすべてのファイルをバックアップする

例 10: テープドライブへのバックアップを作成する