Backup-SqlDatabase

Referensi

Modul:: SQLServer

Mencadangkan objek database SQL Server.

Sintaks

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

Deskripsi

Cmdlet Backup-SqlDatabase melakukan operasi pencadangan pada database SQL Server.

Ini termasuk pencadangan database lengkap, pencadangan log transaksi, dan pencadangan file database.

Cmdlet ini dimodelkan setelah kelas Microsoft.SqlServer.Management.Smo.Backup.

Parameter pada kelas ini umumnya sesuai dengan properti pada objek Smo tersebut.

Untuk mencadangkan database menurut jalur instans server dan nama database, tentukan jalur instans server di parameter Jalur dan nama database di parameter Database.

Untuk mencadangkan database menggunakan objek Smo.Server dan nama database, tentukan objek Smo.Server dalam parameter InputObject, baik secara langsung atau dengan menggunakan operator alur, dan nama database dalam parameter Database.

Untuk mencadangkan database menurut instans server dan nama database, tentukan instans server di parameter ServerInstance dan nama database dalam parameter Database.

Untuk mencadangkan database menggunakan objek Smo.Database, tentukan objek Smo.Database di parameter DatabaseObject, baik secara langsung atau dengan menggunakan operator alur.

Secara default cmdlet ini melakukan pencadangan database lengkap.

Atur jenis cadangan dengan menggunakan parameter BackupAction.

Secara default, file cadangan disimpan di lokasi pencadangan server default dengan nama databasename.bak untuk pencadangan file dan/atau lengkap dan di bawah nama databasename.trn untuk cadangan log. Untuk menentukan nama file yang berbeda, gunakan parameter BackupFile.

Untuk menentukan lokasi file cadangan dan menggunakan nama file yang dibuat secara otomatis, tentukan lokasi dengan menggunakan parameter BackupContainer.

Contoh

Contoh 1: Mencadangkan database lengkap

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

Perintah ini membuat cadangan database lengkap database bernama 'MainDB' ke lokasi cadangan default instans server 'Computer\Instance'. File cadangan diberi nama 'MainDB.bak'.

Contoh 2: Mencadangkan database berdasarkan lokasi

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

Perintah ini membuat cadangan database lengkap dari database 'MainDB' ke lokasi cadangan default instans server 'Computer\Instance'. Direktori kerja saat ini digunakan untuk menentukan instans server tempat pencadangan terjadi.

Contoh 3: Cadangkan log transaksi

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

Perintah ini membuat cadangan log transaksi database 'MainDB' ke lokasi cadangan default instans server 'Computer\Instance'. File cadangan diberi nama 'MainDB.trn'.

Contoh 4: Mencadangkan database dan meminta kredensial

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

Perintah ini membuat cadangan database lengkap dari database 'MainDB' menggunakan login SQL Server 'sa'. Perintah ini meminta kata sandi untuk menyelesaikan autentikasi.

Contoh 5: Mencadangkan database ke berbagi file jaringan

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

Perintah ini membuat cadangan database lengkap dari database 'MainDB' ke file "\\mainserver\databasebackup\MainDB.bak".

Contoh 6: Mencadangkan semua database dalam instans server

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

Perintah ini mencadangkan semua database pada instans server 'Computer\Instance' ke lokasi cadangan default. File cadangan diberi nama database <>.bak.

Contoh 7: Mencadangkan semua database dalam instans server ke berbagi file jaringan

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" }

Perintah ini membuat cadangan penuh untuk setiap database pada instans server 'Computer\Instance' ke berbagi "\\mainserver\databasebackup". File cadangan diberi nama database <>.bak.

Contoh 8: Mencadangkan semua file dalam grup file sekunder

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

Perintah ini membuat cadangan file lengkap dari setiap file di grup file sekunder 'FileGroupJan' dan 'FileGroupFeb'.

Contoh 9: Membuat cadangan diferensial

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

Perintah ini membuat cadangan diferensial database 'MainDB' ke lokasi cadangan default instans server 'Computer\Instance'. File cadangan diberi nama "MainDB.bak".

Contoh 10: Membuat cadangan ke drive pita

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

Perintah ini membuat cadangan lengkap database MainDB ke perangkat pita "\\.\tape0". Untuk mewakili perangkat ini, perintah membuat instans objek Microsoft.Sqlserver.Management.Smo.BackupDeviceItem. Konstruktor mengambil dua argumen, nama perangkat cadangan dan jenis perangkat cadangan. Objek BackupDeviceItem ini diteruskan ke parameter BackupDevice dari cmdlet Backup-SqlDatabase .

Contoh 11: Mencadangkan database ke layanan Azure Blob Storage

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

Perintah ini membuat cadangan lengkap database 'MainDB' ke layanan Windows Azure Blob Storage. Ini menggunakan BackupContainer untuk menentukan lokasi (URL) kontainer Windows Azure Blob. Nama file cadangan dibuat secara otomatis. Parameter SqlCredential digunakan untuk menentukan nama info masuk SQL Server yang menyimpan informasi autentikasi.

Contoh 12: Cadangkan database ke layanan Azure Blob Storage dan tentukan nama file

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

Perintah ini membuat cadangan lengkap database MainDB ke layanan Windows Azure Blob Storage. Ini menggunakan parameter BackupFile untuk menentukan lokasi (URL) dan nama file cadangan. Parameter SqlCredential digunakan untuk menentukan nama info masuk SQL Server.

Contoh 13: Mencadangkan semua database ke layanan Azure Blob Storage

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

Perintah ini mencadangkan semua database pada instans server 'Computer\Instance' ke lokasi layanan Windows Azure Blob Storage dengan menggunakan parameter BackupContainer. Nama file cadangan dibuat secara otomatis.

Contoh 14: Membuat cadangan terenkripsi

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

Contoh ini membuat opsi enkripsi dan menggunakannya sebagai nilai parameter di Backup-SqlDatabase untuk membuat cadangan terenkripsi.

Parameter

-AccessToken

Token akses yang digunakan untuk mengautentikasi ke SQL Server, sebagai alternatif untuk pengguna/kata sandi atau Autentikasi Windows.

Ini dapat digunakan, misalnya, untuk menyambungkan ke SQL Azure DB dan SQL Azure Managed Instance menggunakan Service Principal atau Managed Identity.

Parameter yang digunakan dapat berupa string yang mewakili token atau objek PSAccessToken seperti yang dikembalikan dengan menjalankan Get-AzAccessToken -ResourceUrl https://database.windows.net.

Parameter ini baru dalam v22 modul.

Jenis:	PSObject
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-BackupAction

Menentukan jenis operasi pencadangan yang akan dilakukan. Nilai yang valid adalah:

Basis data. Mencadangkan semua file data dalam database.
File. Mencadangkan file data yang ditentukan dalam parameter DatabaseFile atau DatabaseFileGroup.
Batang. Mencadangkan log transaksi.

Jenis:	BackupActionType
Nilai yang diterima:	Database, Files, Log
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-BackupContainer

Menentukan folder atau lokasi tempat cmdlet menyimpan cadangan. Ini bisa menjadi folder pada disk atau URL untuk kontainer Azure Blob. Parameter ini dapat berguna saat mencadangkan beberapa database dalam instans tertentu. Parameter ini tidak dapat digunakan dengan parameter BackupDevice. Parameter BackupContainer tidak dapat digunakan dengan parameter BackupFile.

Jalur yang digunakan untuk menentukan lokasi harus diakhir dengan garis miring (/).

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-BackupDevice

Menentukan perangkat tempat cadangan disimpan. Parameter ini tidak dapat digunakan dengan parameter BackupFile. Gunakan parameter ini jika Anda mencadangkan ke pita.

Jenis:	BackupDeviceItem[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-BackupFile

Menentukan lokasi dan nama file untuk cadangan.

Ini adalah parameter opsional.

Jika tidak ditentukan, cadangan disimpan di lokasi cadangan default server dengan nama databasename.bak untuk pencadangan file dan lengkap, atau databasename.trn untuk cadangan log.

Saat mencadangkan ke beberapa file, pisahkan nama file dengan koma, misalnya: -BackupFile C:\Backups\databasename2.bak,C:\Backups\databasename2.bak

Parameter ini tidak dapat digunakan dengan parameter -BackupDevice atau -BackupContainer.

Jenis:	String[]
Position:	2
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-BackupSetDescription

Menentukan deskripsi kumpulan cadangan. Parameter ini bersifat opsional.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-BackupSetName

Menentukan nama kumpulan cadangan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-BlockSize

Menentukan ukuran blok fisik untuk cadangan, dalam byte. Ukuran yang didukung adalah 512, 1024, 2048, 4096, 8192, 16384, 32768, dan 65536 (64 KB) byte. Defaultnya adalah 65536 untuk perangkat pita dan 512 untuk semua perangkat lainnya.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-BufferCount

Menentukan jumlah buffer I/O yang akan digunakan untuk operasi pencadangan. Anda dapat menentukan bilangan bulat positif apa pun. Jika ruang alamat virtual tidak mencukup dalam proses Sqlservr.exe untuk buffer, Anda akan menerima kesalahan kehabisan memori.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Checksum

Menunjukkan bahwa nilai checksum dihitung selama operasi pencadangan.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-CompressionOption

Menentukan opsi pemadatan untuk operasi pencadangan.

Jenis:	BackupCompressionOptions
Nilai yang diterima:	Default, On, Off
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet. Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ConnectionTimeout

Menentukan jumlah detik untuk menunggu koneksi server sebelum kegagalan waktu habis. Nilai batas waktu harus berupa bilangan bulat antara 0 dan 65534. Jika 0 ditentukan, upaya koneksi tidak batas waktu.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ContinueAfterError

Menunjukkan bahwa operasi berlanjut ketika terjadi kesalahan checksum. Jika tidak diatur, operasi akan gagal setelah kesalahan checksum.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-CopyOnly

Menunjukkan bahwa cadangan adalah cadangan khusus salinan. Pencadangan khusus salinan tidak memengaruhi urutan normal cadangan konvensional yang dijadwalkan secara teratur.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Credential

Menentukan objek PSCredential yang berisi kredensial untuk login SQL Server yang memiliki izin untuk melakukan operasi ini. Ini bukan objek kredensial SQL yang digunakan untuk menyimpan informasi autentikasi secara internal oleh SQL Server saat mengakses sumber daya di luar SQL Server.

Jenis:	PSCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Database

Menentukan nama database yang akan dicadangkan. Parameter ini tidak dapat digunakan dengan parameter DatabaseObject. Ketika parameter ini ditentukan, parameter Path, InputObject, atau ServerInstance juga harus ditentukan.

Jenis:	String
Position:	1
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-DatabaseFile

Menentukan satu atau beberapa file database untuk dicadangkan. Parameter ini hanya digunakan ketika BackupAction diatur ke File. Saat BackupAction diatur ke File, parameter DatabaseFileGroups atau DatabaseFiles harus ditentukan.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DatabaseFileGroup

Menentukan grup file database yang ditargetkan oleh operasi pencadangan. Parameter ini hanya digunakan ketika properti BackupAction diatur ke File. Ketika parameter BackupAction diatur ke File, parameter DatabaseFileGroups atau DatabaseFiles harus ditentukan.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DatabaseObject

Menentukan objek database untuk operasi pencadangan.

Jenis:	Database
Position:	1
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-Encrypt

Jenis enkripsi yang akan digunakan saat menyambungkan ke SQL Server.

Nilai ini memetakan ke properti EncryptSqlConnectionEncryptOption pada objek SqlConnection driver Microsoft.Data.SqlClient.

Dalam v22 modul, defaultnya adalah Optional (untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah 'Wajib', yang dapat membuat perubahan yang melanggar untuk skrip yang ada.

Parameter ini baru dalam v22 modul.

Jenis:	String
Nilai yang diterima:	Mandatory, Optional, Strict
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-EncryptionOption

Menentukan opsi enkripsi untuk operasi pencadangan.

Jenis:	BackupEncryptionOptions
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ExpirationDate

Menentukan tanggal dan waktu ketika set cadangan kedaluwarsa dan data cadangan tidak lagi dianggap valid. Ini hanya dapat digunakan untuk data cadangan yang disimpan di disk atau perangkat pita. Set cadangan yang lebih lama dari tanggal kedaluwarsa tersedia untuk ditimpa oleh cadangan yang lebih baru.

Jenis:	DateTime
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-FormatMedia

Menunjukkan bahwa pita diformat sebagai langkah pertama operasi pencadangan. Ini tidak berlaku untuk cadangan disk.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-HostNameInCertificate

Nama host yang akan digunakan dalam memvalidasi sertifikat SQL Server TLS/SSL. Anda harus meneruskan parameter ini jika instans SQL Server Anda diaktifkan untuk Enkripsi Paksa dan Anda ingin terhubung ke instans menggunakan nama host/nama pendek. Jika parameter ini dihilangkan, maka meneruskan Nama Domain yang Sepenuhnya Memenuhi Syarat (FQDN) ke -ServerInstance diperlukan untuk terhubung ke instans SQL Server yang diaktifkan untuk Enkripsi Paksa.

Parameter ini baru dalam v22 modul.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Incremental

Menunjukkan bahwa pencadangan diferensial dilakukan.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Initialize

Menunjukkan bahwa perangkat yang terkait dengan operasi pencadangan diinisialisasi. Ini menimpa set cadangan yang ada pada media dan menjadikan cadangan ini sebagai cadangan pertama yang diatur pada media.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-InputObject

Menentukan objek server untuk lokasi cadangan.

Jenis:	Server[]
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-LogTruncationType

Menentukan perilaku pemotongan untuk pencadangan log. Nilai yang valid adalah:

-- TruncateOnly -- NoTruncate -- Potong

Nilai defaultnya adalah Potong.

Jenis:	BackupTruncateLogType
Nilai yang diterima:	TruncateOnly, NoTruncate, Truncate
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-MaxTransferSize

Menentukan jumlah maksimum byte yang akan ditransfer antara media cadangan dan instans SQL Server. Nilai yang mungkin adalah kelipatan 65536 byte (64 KB), hingga 4194304 byte (4 MB).

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-MediaDescription

Menentukan deskripsi untuk media yang berisi kumpulan cadangan. Parameter ini bersifat opsional.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-MediaName

Menentukan nama yang digunakan untuk mengidentifikasi set media.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-MirrorDevices

Menentukan array objek BackupDeviceList yang digunakan oleh cadangan yang dicerminkan.

Jenis:	BackupDeviceList[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-NoRecovery

Menunjukkan bahwa ujung ekor log tidak dicadangkan. Saat dipulihkan, database berada dalam status pemulihan. Saat tidak diatur, ujung ekor log dicadangkan. Ini hanya berlaku ketika parameter BackupAction diatur ke Log.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-NoRewind

Menunjukkan bahwa drive pita dibiarkan terbuka pada posisi akhir saat pencadangan selesai. Ketika tidak diatur, pita diulang setelah operasi selesai. Ini tidak berlaku untuk cadangan disk atau URL.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-PassThru

Menunjukkan bahwa cmdlet menghasilkan objek Smo.Backup yang melakukan pencadangan.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Path

Menentukan jalur ke instans SQL Server untuk menjalankan operasi pencadangan. Ini adalah parameter opsional. Jika tidak ditentukan, nilai parameter ini default ke lokasi kerja saat ini.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ProgressAction

Menentukan bagaimana PowerShell merespons pembaruan kemajuan yang dihasilkan oleh skrip, cmdlet, atau penyedia, seperti bilah kemajuan yang dihasilkan oleh cmdlet Write-Progress. cmdlet Write-Progress membuat bilah kemajuan yang memperlihatkan status perintah.

Jenis:	ActionPreference
Alias:	proga
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Restart

Menunjukkan bahwa cmdlet terus memproses operasi pencadangan yang diselesaikan sebagian. Jika tidak diatur, cmdlet memulai ulang operasi pencadangan yang terganggu di awal kumpulan cadangan.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-RetainDays

Menentukan jumlah hari yang harus berlalu sebelum kumpulan cadangan dapat ditimpa. Ini hanya dapat digunakan untuk data cadangan yang disimpan di disk atau perangkat pita.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Script

Menunjukkan bahwa cmdlet ini menghasilkan skrip Transact-SQL yang melakukan operasi pencadangan.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ServerInstance

Menentukan nama instans SQL Server. Instans server ini menjadi target operasi pencadangan.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-SkipTapeHeader

Menunjukkan bahwa header pita tidak dibaca.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-SqlCredential

Menentukan objek kredensial SQL Server yang menyimpan informasi autentikasi. Jika Anda mencadangkan ke layanan penyimpanan Blob, Anda harus menentukan parameter ini. Informasi autentikasi yang disimpan mencakup nama akun Penyimpanan dan nilai kunci akses terkait. Jangan tentukan parameter ini untuk disk atau pita.

Jenis:	PSObject
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-StatementTimeout

Atur batas waktu (dalam detik) untuk operasi pencadangan.

Jika nilainya adalah 0 atau parameter StatementTimeout tidak ditentukan, operasi pemulihan tidak akan habis.

Jenis:	Int32
Position:	Named
Nilai default:	0
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-TrustServerCertificate

Menunjukkan apakah saluran akan dienkripsi saat melewati rantai sertifikat untuk memvalidasi kepercayaan.

Dalam v22 modul, defaultnya adalah $true (untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah '$false', yang dapat membuat perubahan yang melanggar untuk skrip yang ada.

Parameter ini baru dalam v22 modul.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-UndoFileName

Menentukan nama file urungkan yang digunakan untuk menyimpan transaksi yang tidak dilakukan yang digulung balik selama pemulihan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-UnloadTapeAfter

Menunjukkan bahwa perangkat pita digabungkan dan dibongkar ketika operasi selesai. Jika tidak diatur, tidak ada upaya yang dilakukan untuk memutar balik dan membongkar media pita. Ini tidak berlaku untuk cadangan disk atau URL.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan. Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Input

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

Menentukan SMO. Objek server yang mengacu pada instans SQL Server tempat operasi pencadangan terjadi.

System.String[]

Output

System.Object

Restore-SqlDatabase

Bagikan melalui

Backup-SqlDatabase

Sintaks

Deskripsi

Contoh

Contoh 1: Mencadangkan database lengkap

Contoh 2: Mencadangkan database berdasarkan lokasi

Contoh 3: Cadangkan log transaksi

Contoh 4: Mencadangkan database dan meminta kredensial

Contoh 5: Mencadangkan database ke berbagi file jaringan

Contoh 6: Mencadangkan semua database dalam instans server

Contoh 7: Mencadangkan semua database dalam instans server ke berbagi file jaringan

Contoh 8: Mencadangkan semua file dalam grup file sekunder

Contoh 9: Membuat cadangan diferensial

Contoh 10: Membuat cadangan ke drive pita

Contoh 11: Mencadangkan database ke layanan Azure Blob Storage

Contoh 12: Cadangkan database ke layanan Azure Blob Storage dan tentukan nama file

Contoh 13: Mencadangkan semua database ke layanan Azure Blob Storage

Contoh 14: Membuat cadangan terenkripsi

Parameter

-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

Input

Output

Link Terkait

Saran dan Komentar

Saran dan Komentar

Sumber Daya Tambahan: