Backup-SqlDatabase
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