Backup-SqlDatabase

Modul:

SqlServer Module

Mencadangkan objek database SQL Server.

Sintaks

ByPath (Default)

Backup-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    [-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>]
    [-Path <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>]

ByDBObject

Backup-SqlDatabase
    [-DatabaseObject] <Database>
    [[-BackupFile] <String[]>]
    [-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>]
    [-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>]

ByName

Backup-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -ServerInstance <String[]>
    [-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>]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-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>]

ByObject

Backup-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -InputObject <Server[]>
    [-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>]
    [-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>]

ByBackupContainer

Backup-SqlDatabase
    [[-BackupFile] <String[]>]
    [-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>]
    [-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 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 seperti yang PSAccessToken dikembalikan dengan menjalankan Get-AzAccessToken -ResourceUrl https://database.windows.net.

Parameter ini baru dalam v22 modul.

Properti parameter

Jenis:	PSObject
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.
• Batang. Mencadangkan log transaksi.

Properti parameter

Jenis:	BackupActionType
Nilai default:	None
Nilai yang diterima:	Database, Files, Log
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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 (/).

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-BackupDevice

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

Properti parameter

Jenis:	BackupDeviceItem[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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 -BackupDevice parameter atau -BackupContainer .

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	2
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-BackupSetDescription

Menentukan deskripsi kumpulan cadangan. Parameter ini bersifat opsional.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-BackupSetName

Menentukan nama kumpulan cadangan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Int32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Int32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Checksum

Menunjukkan bahwa nilai checksum dihitung selama operasi pencadangan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CompressionOption

Menentukan opsi pemadatan untuk operasi pencadangan.

Properti parameter

Jenis:	BackupCompressionOptions
Nilai default:	None
Nilai yang diterima:	Default, On, Off
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Confirm

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Int32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ContinueAfterError

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CopyOnly

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByPath

Position:	1
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ByName

Position:	1
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ByObject

Position:	1
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DatabaseObject

Menentukan objek database untuk operasi pencadangan.

Properti parameter

Jenis:	Database
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByDBObject

Position:	1
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Encrypt

Jenis enkripsi yang akan 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.

Properti parameter

Jenis:	String
Nilai default:	None
Nilai yang diterima:	Mandatory, Optional, Strict
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-EncryptionOption

Menentukan opsi enkripsi untuk operasi pencadangan.

Properti parameter

Jenis:	BackupEncryptionOptions
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	DateTime
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-FormatMedia

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Incremental

Menunjukkan bahwa pencadangan diferensial dilakukan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-InputObject

Menentukan objek server untuk lokasi cadangan.

Properti parameter

Jenis:	Server[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByObject

Position:	Named
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-LogTruncationType

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

-- TruncateOnly -- NoTruncate -- Potong

Nilai defaultnya adalah Potong.

Properti parameter

Jenis:	BackupTruncateLogType
Nilai default:	None
Nilai yang diterima:	TruncateOnly, NoTruncate, Truncate
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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).

Properti parameter

Jenis:	Int32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-MediaDescription

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-MediaName

Menentukan nama yang digunakan untuk mengidentifikasi set media.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-MirrorDevices

Menentukan array objek BackupDeviceList yang digunakan oleh cadangan yang dicerminkan.

Properti parameter

Jenis:	BackupDeviceList[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-PassThru

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByPath

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Int32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Script

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ServerInstance

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByName

Position:	Named
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-SkipTapeHeader

Menunjukkan bahwa header pita tidak dibaca.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	PSObject
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Int32
Nilai default:	0
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-UndoFileName

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WhatIf

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

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

Link Terkait

• Restore-SqlDatabase