Backup-SqlDatabase

Referensi

Modul:: SQLServer

Mencadangkan SQL Server objek database.

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

Deskripsi

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

Ini termasuk pencadangan database lengkap, pencadangan log transaksi, dan cadangan 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 di 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 cadangan 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 'sa' SQL Server masuk. 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 pencadangan 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 Azure Blob Storage Windows. Ini menggunakan BackupContainer untuk menentukan lokasi (URL) kontainer Windows Azure Blob. Nama file cadangan dibuat secara otomatis. Parameter SqlCredential digunakan untuk menentukan nama kredensial 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 Azure Blob Storage Windows. Ini menggunakan parameter BackupFile untuk menentukan lokasi (URL) dan nama file cadangan. Parameter SqlCredential digunakan untuk menentukan nama kredensial 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 terhubung ke SQL Azure DB dan SQL Azure Managed Instance menggunakan Service Principal atau Managed Identity.

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

Parameter ini baru dalam v22 modul.

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

-BackupAction

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

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

Type:	BackupActionType
Accepted values:	Database, Files, Log
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 (/).

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

-BackupDevice

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

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

-BackupFile

Menentukan lokasi dan nama file 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. Parameter ini tidak dapat digunakan dengan parameter BackupDevice atau BackupContainer.

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

-BackupSetDescription

Menentukan deskripsi kumpulan cadangan. Parameter ini bersifat opsional.

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

-BackupSetName

Menentukan nama kumpulan cadangan.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 cukup dalam proses Sqlservr.exe untuk buffer, Anda akan menerima kesalahan kehabisan memori.

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

-Checksum

Menunjukkan bahwa nilai checksum dihitung selama operasi pencadangan.

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

-CompressionOption

Menentukan opsi pemadatan untuk operasi pencadangan.

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

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 habis waktu.

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

-ContinueAfterError

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

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

-CopyOnly

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-DatabaseFile

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-DatabaseObject

Menentukan objek database untuk operasi pencadangan.

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

-Encrypt

Jenis enkripsi yang digunakan saat menyambungkan ke SQL Server.

Nilai ini memetakan ke Encrypt properti SqlConnectionEncryptOption pada objek SqlConnection dari 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.

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

-EncryptionOption

Menentukan opsi enkripsi untuk operasi pencadangan.

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

-ExpirationDate

Menentukan tanggal dan waktu ketika kumpulan 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 nanti.

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

-FormatMedia

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

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

-HostNameInCertificate

Nama host yang akan digunakan dalam memvalidasi sertifikat TLS/SSL SQL Server. 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.

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

-Incremental

Menunjukkan bahwa pencadangan diferensial dilakukan.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-InputObject

Menentukan objek server untuk lokasi pencadangan.

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

-LogTruncationType

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

-- TruncateOnly -- NoTruncate -- Potong

Nilai defaultnya adalah Truncate.

Type:	BackupTruncateLogType
Accepted values:	TruncateOnly, NoTruncate, Truncate
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

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

-MediaDescription

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

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

-MediaName

Menentukan nama yang digunakan untuk mengidentifikasi set media.

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

-MirrorDevices

Menentukan array objek BackupDeviceList yang digunakan oleh cadangan yang dicerminkan.

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

-NoRecovery

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

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

-NoRewind

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

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

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Restart

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Script

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

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

-ServerInstance

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

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

-SkipTapeHeader

Menunjukkan bahwa header pita tidak dibaca.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 menyertakan nama akun Penyimpanan dan nilai kunci akses terkait. Jangan tentukan parameter ini untuk disk atau pita.

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

-StatementTimeout

Atur batas waktu (dalam detik) untuk operasi pencadangan.

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

Type:	Int32
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 mencolok untuk skrip yang ada.

Parameter ini baru dalam v22 modul.

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

-UndoFileName

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

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

-UnloadTapeAfter

Menunjukkan bahwa perangkat pita disusun ulang dan dibongkar saat 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.

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

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

-Restart

-RetainDays

-Script

-ServerInstance

-SkipTapeHeader

-SqlCredential

-StatementTimeout

-TrustServerCertificate

-UndoFileName

-UnloadTapeAfter

-WhatIf

Input

Output

Link Terkait

Sumber Daya Tambahan: