Restore-SqlDatabase

Referensi

Modul:: SQLServer

Memulihkan database dari rekaman log cadangan atau transaksi.

Sintaks

Restore-SqlDatabase
       [-ClearSuspectPageTable]
       [-KeepReplication]
       [-Partial]
       [-ReplaceDatabase]
       [-RestrictedUser]
       [-Offset <Int64[]>]
       [-RelocateFile <RelocateFile[]>]
       [-AutoRelocateFile]
       [-FileNumber <Int32>]
       [-RestoreAction <RestoreActionType>]
       [-StandbyFile <String>]
       [-StopAtMarkAfterDate <String>]
       [-StopAtMarkName <String>]
       [-StopBeforeMarkAfterDate <String>]
       [-StopBeforeMarkName <String>]
       [-ToPointInTime <String>]
       [-Database] <String>
       [-Path <String[]>]
       [[-BackupFile] <String[]>]
       [-SqlCredential <PSObject>]
       [-BackupDevice <BackupDeviceItem[]>]
       [-PassThru]
       [-Checksum]
       [-ContinueAfterError]
       [-NoRewind]
       [-Restart]
       [-UnloadTapeAfter]
       [-NoRecovery]
       [-DatabaseFile <String[]>]
       [-DatabaseFileGroup <String[]>]
       [-BlockSize <Int32>]
       [-BufferCount <Int32>]
       [-MaxTransferSize <Int32>]
       [-MediaName <String>]
       [-Script]
       [-AccessToken <PSObject>]
       [-TrustServerCertificate]
       [-HostNameInCertificate <String>]
       [-Encrypt <String>]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-SqlDatabase
       [-ClearSuspectPageTable]
       [-KeepReplication]
       [-Partial]
       [-ReplaceDatabase]
       [-RestrictedUser]
       [-Offset <Int64[]>]
       [-RelocateFile <RelocateFile[]>]
       [-AutoRelocateFile]
       [-FileNumber <Int32>]
       [-RestoreAction <RestoreActionType>]
       [-StandbyFile <String>]
       [-StopAtMarkAfterDate <String>]
       [-StopAtMarkName <String>]
       [-StopBeforeMarkAfterDate <String>]
       [-StopBeforeMarkName <String>]
       [-ToPointInTime <String>]
       [-Database] <String>
       -ServerInstance <String[]>
       [-Credential <PSCredential>]
       [-ConnectionTimeout <Int32>]
       [[-BackupFile] <String[]>]
       [-SqlCredential <PSObject>]
       [-BackupDevice <BackupDeviceItem[]>]
       [-PassThru]
       [-Checksum]
       [-ContinueAfterError]
       [-NoRewind]
       [-Restart]
       [-UnloadTapeAfter]
       [-NoRecovery]
       [-DatabaseFile <String[]>]
       [-DatabaseFileGroup <String[]>]
       [-BlockSize <Int32>]
       [-BufferCount <Int32>]
       [-MaxTransferSize <Int32>]
       [-MediaName <String>]
       [-Script]
       [-AccessToken <PSObject>]
       [-TrustServerCertificate]
       [-HostNameInCertificate <String>]
       [-Encrypt <String>]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-SqlDatabase
       [-ClearSuspectPageTable]
       [-KeepReplication]
       [-Partial]
       [-ReplaceDatabase]
       [-RestrictedUser]
       [-Offset <Int64[]>]
       [-RelocateFile <RelocateFile[]>]
       [-AutoRelocateFile]
       [-FileNumber <Int32>]
       [-RestoreAction <RestoreActionType>]
       [-StandbyFile <String>]
       [-StopAtMarkAfterDate <String>]
       [-StopAtMarkName <String>]
       [-StopBeforeMarkAfterDate <String>]
       [-StopBeforeMarkName <String>]
       [-ToPointInTime <String>]
       [-Database] <String>
       -InputObject <Server[]>
       [[-BackupFile] <String[]>]
       [-SqlCredential <PSObject>]
       [-BackupDevice <BackupDeviceItem[]>]
       [-PassThru]
       [-Checksum]
       [-ContinueAfterError]
       [-NoRewind]
       [-Restart]
       [-UnloadTapeAfter]
       [-NoRecovery]
       [-DatabaseFile <String[]>]
       [-DatabaseFileGroup <String[]>]
       [-BlockSize <Int32>]
       [-BufferCount <Int32>]
       [-MaxTransferSize <Int32>]
       [-MediaName <String>]
       [-Script]
       [-AccessToken <PSObject>]
       [-TrustServerCertificate]
       [-HostNameInCertificate <String>]
       [-Encrypt <String>]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-SqlDatabase
       [-ClearSuspectPageTable]
       [-KeepReplication]
       [-Partial]
       [-ReplaceDatabase]
       [-RestrictedUser]
       [-Offset <Int64[]>]
       [-RelocateFile <RelocateFile[]>]
       [-AutoRelocateFile]
       [-FileNumber <Int32>]
       [-RestoreAction <RestoreActionType>]
       [-StandbyFile <String>]
       [-StopAtMarkAfterDate <String>]
       [-StopAtMarkName <String>]
       [-StopBeforeMarkAfterDate <String>]
       [-StopBeforeMarkName <String>]
       [-ToPointInTime <String>]
       [-DatabaseObject] <Database>
       [[-BackupFile] <String[]>]
       [-SqlCredential <PSObject>]
       [-BackupDevice <BackupDeviceItem[]>]
       [-PassThru]
       [-Checksum]
       [-ContinueAfterError]
       [-NoRewind]
       [-Restart]
       [-UnloadTapeAfter]
       [-NoRecovery]
       [-DatabaseFile <String[]>]
       [-DatabaseFileGroup <String[]>]
       [-BlockSize <Int32>]
       [-BufferCount <Int32>]
       [-MaxTransferSize <Int32>]
       [-MediaName <String>]
       [-Script]
       [-AccessToken <PSObject>]
       [-TrustServerCertificate]
       [-HostNameInCertificate <String>]
       [-Encrypt <String>]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Deskripsi

Cmdlet Restore-SqlDatabase melakukan operasi pemulihan pada database SQL Server. Ini termasuk pemulihan database lengkap, pemulihan log transaksi, dan pemulihan file database.

Cmdlet ini dimodelkan setelah kelas Microsoft.SqlServer.Management.Smo.Restore. Parameter pada cmdlet ini umumnya sesuai dengan properti pada objek Smo.Restore.

Contoh

Contoh 1: Memulihkan database dari file cadangan pada berbagi jaringan

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

Perintah ini memulihkan MainDB database lengkap dari file \\mainserver\databasebackup\MainDB.bak ke instans server Computer\Instance.

Contoh 2: Memulihkan log transaksi database

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log

Perintah ini memulihkan log transaksi untuk database MainDB dari file \\mainserver\databasebackup\MainDB.trn ke instans server Computer\Instance.

Contoh 3: Memulihkan database dan meminta kata sandi

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.bak" -Credential (Get-Credential "sa")

Perintah ini memulihkan MainDB database lengkap dari file \\mainserver\databasebackup\MainDB.bak ke instans server Computer\Instance, menggunakan login SQL sa. Perintah ini akan meminta kata sandi untuk menyelesaikan autentikasi.

Contoh 4: Memulihkan log transaksi dengan opsi NORECOVERY

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log -NoRecovery

Perintah ini memulihkan log transaksi database MainDB dengan opsi NORECOVERY dari file \\mainserver\databasebackup\MainDB.trn ke instans server Computer\Instance.

Contoh 5: Memulihkan rekaman log transaksi hingga titik waktu tertentu

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log -ToPointInTime "Sep 21, 2017 11:11 PM"

Perintah ini memulihkan log transaksi database terbaru hingga tanggal yang diteruskan ke parameter ToPointInTime, 21 Sep 2017 11:11 PM.

Contoh 6: Memulihkan database dan merelokasi data dan file log

PS C:\> $RelocateData = New-Object Microsoft.SqlServer.Management.Smo.RelocateFile("MainDB_Data", "c:\MySQLServer\MainDB.mdf")
PS C:\> $RelocateLog = New-Object Microsoft.SqlServer.Management.Smo.RelocateFile("MainDB_Log", "c:\MySQLServer\MainDB.ldf")
PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RelocateFile @($RelocateData,$RelocateLog)

Contoh ini memulihkan database lengkap MainDB ke instans server Computer\Instance, dan merelokasi data dan file log. Untuk setiap file yang dipindahkan, contoh membuat instans kelas Microsoft.SqlServer.Management.Smo.RelocateFile. Setiap konstruktor mengambil dua argumen, nama logis file dan lokasi fisik tempat file akan ditempatkan di server target. Objek RelocateFile diteruskan ke parameter RelocateFile dari cmdlet Restore-SqlDatabase.

Contoh 7: Memulihkan database dari pita

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

Contoh ini memulihkan MainDB database dari perangkat pita bernama \\.\tape0 ke instans server Computer\Instance. Untuk mewakili perangkat ini, contoh membuat instans kelas Microsoft.Sqlserver.Management.Smo.BackupDeviceItem. Konstruktor mengambil dua argumen, nama perangkat cadangan dan jenis perangkat cadangan. Objek BackupDeviceItem ini kemudian diteruskan ke parameter BackupDevice cmdlet Restore-SqlDatabase.

Contoh 8: Memulihkan database dari layanan Azure Blob Storage

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "https://mystorageaccountname.blob.core.windows.net/container/MyDB.bak" -SqlCredential "mySqlCredential"

Perintah ini memulihkan MainDB database lengkap dari file pada layanan Windows Azure Blob Storage ke instans server Computer\Instance.

Contoh 9: Cadangkan database di SQL2016 dan pulihkan di SQL2017 menggunakan -AutoRelocateFile

PS C:\> Get-SqlDatabase -ServerInstance MYSERVER\SQL2016 -Database AdventureWorks | Backup-SqlDatabase -BackupFile 'C:\BAK2\AdventureWorks.bak'
PS C:\> $restore = Restore-SqlDatabase -ServerInstance MYSERVER\SQL2017 -Database AdventureWorks2016 -BackupFile 'C:\BAK2\AdventureWorks.bak' -AutoRelocateFile -PassThru
PS C:\> $db.RelocateFiles

LogicalFileName     PhysicalFileName
---------------     ----------------
AdventureWorks_Data C:\Program Files\Microsoft SQL Server\MSSQL14.SQL2017\MSSQL\DATA\AdventureWorks_Data.mdf
AdventureWorks_Log  C:\Program Files\Microsoft SQL Server\MSSQL14.SQL2017\MSSQL\DATA\AdventureWorks_Log.ldf

# You can see that the original PhysicalFileNames were indeed differet by running the followiong query:
PS C:\> Invoke-Sqlcmd -ServerInstance MYSERVER\SQL2016 -Query "RESTORE FILELISTONLY FROM  DISK = N'C:\BAK2\AdventureWorks.bak' WITH NOUNLOAD" | Select -Property LogicalName,PhysicalName

LogicalName         PhysicalName
-----------         ------------
AdventureWorks_Data C:\Program Files\Microsoft SQL Server\MSSQL13.SQL2016\MSSQL\DATA\AdventureWorks_Data.mdf
AdventureWorks_Log  C:\Program Files\Microsoft SQL Server\MSSQL13.SQL2016\MSSQL\DATA\AdventureWorks_Log.ldf

Perintah pertama mengambil cadangan database AdventureWorks pada instans SQL2016 yang berjalan pada komputer MYSERVER. Cadangan disimpan di bawah C:\BAK2.

File cadangan yang sama digunakan dalam cmdlet kedua untuk memulihkan database pada instans SQL2017 yang berjalan pada komputer yang sama (MYSERVER). Perhatikan bahwa tanpa sakelar -AutoRelocate, cmdlet akan gagal karena file fisik di mana berbeda, seperti yang ditunjukkan pada dua tabel di atas (selanjutnya, kemungkinan besar file akan digunakan oleh SQL2016 dan mungkin tidak dapat diakses oleh SQL2017). -AutoRelocate memungkinkan pengguna untuk menghindari keharusan menggunakan -RelocationFile, argumen yang cukup melelahkan untuk dibangun.

Catatan: ada asumsi bahwa instans SQL2016 dan instans SQL2017 memiliki akses ke folder C:\BAK2.

Parameter

-AccessToken

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

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

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

Parameter ini baru dalam v22 modul.

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

-AutoRelocateFile

Ketika sakelar ini ditentukan, cmdlet akan menangani secara otomatis memindahkan semua file logis dalam cadangan, kecuali file logis tersebut ditentukan dengan RelocateFile. Server DefaultFile dan DefaultLog digunakan untuk merelokasi file.

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

-BackupDevice

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

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

-BackupFile

Menentukan lokasi atau lokasi tempat file cadangan disimpan. Parameter ini bersifat opsional. Jika tidak ditentukan, lokasi cadangan default server dicari nama <database name>.trn untuk pemulihan log, atau <database name>.bak untuk semua jenis pemulihan lainnya. Parameter ini tidak dapat digunakan dengan parameter BackupDevice . Jika Anda mencadangkan ke layanan Windows Azure Blob Storage (URL), parameter ini atau parameter BackupDevice harus ditentukan.

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

-BlockSize

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

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

-BufferCount

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

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

-Checksum

Menunjukkan bahwa nilai checksum dihitung selama operasi pemulihan.

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

-ClearSuspectPageTable

Menunjukkan bahwa tabel halaman tersangka dihapus setelah operasi pemulihan.

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

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

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

-ConnectionTimeout

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

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

-ContinueAfterError

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

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

-Credential

Menentukan objek PSCredential yang berisi kredensial untuk login SQL Server yang memiliki izin untuk melakukan operasi ini.

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

-Database

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

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

-DatabaseFile

Menentukan file database yang ditargetkan oleh operasi pemulihan. Ini hanya digunakan ketika parameter RestoreAction diatur ke File. Ketika parameter RestoreAction diatur ke File, parameter DatabaseFileGroups atau DatabaseFiles juga harus ditentukan.

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

-DatabaseFileGroup

Menentukan grup file database yang ditargetkan oleh operasi pemulihan. Ini hanya digunakan ketika parameter RestoreAction diatur ke File. Ketika parameter RestoreAction diatur ke File, parameter DatabaseFileGroups atau DatabaseFiles juga harus ditentukan.

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

-DatabaseObject

Menentukan objek database untuk operasi pemulihan.

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

-Encrypt

Jenis enkripsi yang akan digunakan saat menyambungkan ke SQL Server.

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

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

Parameter ini baru dalam v22 modul.

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

-FileNumber

Menentukan nomor indeks yang digunakan untuk mengidentifikasi kumpulan cadangan yang ditargetkan pada media cadangan.

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

-HostNameInCertificate

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

Parameter ini baru dalam v22 modul.

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

-InputObject

Menentukan objek server instans SQL Server tempat pemulihan terjadi.

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

-KeepReplication

Menunjukkan bahwa konfigurasi replikasi dipertahankan. Jika tidak diatur, konfigurasi replikasi diabaikan oleh operasi pemulihan.

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

-MaxTransferSize

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

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

-MediaName

Menentukan nama yang mengidentifikasi set media.

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

-NoRecovery

Menunjukkan bahwa database dipulihkan ke status pemulihan. Operasi gulung balik tidak terjadi dan cadangan tambahan dapat dipulihkan.

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

-NoRewind

Menunjukkan bahwa drive pita dibiarkan terbuka pada posisi akhir saat pemulihan selesai. Jika tidak diatur, pita digabungkan kembali setelah operasi selesai. Ini tidak berlaku untuk pemulihan disk.

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

-Offset

Menentukan alamat halaman yang akan dipulihkan. Ini hanya digunakan ketika RestoreAction diatur ke OnlinePage.

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

-Partial

Menunjukkan bahwa operasi pemulihan adalah pemulihan parsial.

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

-PassThru

Menunjukkan bahwa cmdlet ini menghasilkan objek Smo.Backup yang digunakan untuk melakukan operasi pemulihan.

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

-Path

Menentukan jalur instans SQL Server tempat menjalankan operasi pemulihan. Parameter ini bersifat opsional. Jika tidak ditentukan, lokasi kerja saat ini digunakan.

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

-ProgressAction

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

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

-RelocateFile

Menentukan daftar objek file Smo.Relocate. Setiap objek terdiri dari nama file cadangan logis dan lokasi sistem file fisik. Pemulihan memindahkan database yang dipulihkan ke lokasi fisik yang ditentukan pada server target.

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

-ReplaceDatabase

Menunjukkan bahwa gambar baru database dibuat. Ini menimpa database yang ada dengan nama yang sama. Jika tidak diatur, operasi pemulihan akan gagal ketika database dengan nama tersebut sudah ada di server.

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

-Restart

Menunjukkan bahwa cmdlet ini melanjutkan operasi pemulihan yang diselesaikan sebagian. Jika tidak diatur, cmdlet memulai ulang operasi pemulihan yang terganggu di awal set cadangan.

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

-RestoreAction

Menentukan jenis operasi pemulihan yang dilakukan. Nilai yang valid adalah:

Basis data. Database dipulihkan.
File. Satu atau beberapa file data dipulihkan. Parameter DatabaseFile atau DatabaseFileGroup harus ditentukan.
Halaman Online. Halaman data dipulihkan secara online sehingga database tetap tersedia untuk pengguna.
OnlineFiles. File data dipulihkan secara online sehingga database tetap tersedia untuk pengguna. Parameter DatabaseFile atau DatabaseFileGroup harus ditentukan.
Batang. Log penerjemahan dipulihkan.

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

-RestrictedUser

Menunjukkan bahwa akses ke database yang dipulihkan dibatasi untuk peran database tetap db_owner, dan peran server tetap dbcreator dan sysadmin.

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

-Script

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

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

-ServerInstance

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

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

-SqlCredential

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

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

-StandbyFile

Menentukan nama file urungkan yang digunakan sebagai bagian dari strategi pencitraan untuk instans SQL Server.

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

-StopAtMarkAfterDate

Menentukan tanggal yang akan digunakan dengan nama tanda yang ditentukan oleh parameter StopAtMarkName untuk menentukan titik penghentian operasi pemulihan.

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

-StopAtMarkName

Menentukan transaksi yang ditandai untuk menghentikan operasi pemulihan. Ini digunakan dengan StopAtMarkAfterDate untuk menentukan titik henti operasi pemulihan. Data yang dipulihkan mencakup transaksi yang berisi tanda. Jika nilai StopAtMarkAfterDate tidak diatur, pemulihan akan berhenti pada tanda pertama dengan nama yang ditentukan.

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

-StopBeforeMarkAfterDate

Menentukan tanggal yang akan digunakan dengan StopBeforeMarkName untuk menentukan titik penghentian operasi pemulihan.

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

-StopBeforeMarkName

Menentukan transaksi yang ditandai sebelumnya untuk menghentikan operasi pemulihan. Ini digunakan dengan StopBeforeMarkAfterDate untuk menentukan titik henti operasi pemulihan.

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

-ToPointInTime

Menentukan titik akhir untuk pemulihan log database. Ini hanya berlaku ketika RestoreAction diatur ke Log.

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

-TrustServerCertificate

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

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

Parameter ini baru dalam v22 modul.

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

-UnloadTapeAfter

Menunjukkan bahwa perangkat pita di-rewound 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.

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

-WhatIf

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

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

Input

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

Menentukan SMO. Objek server yang menjelaskan instans SQL Server tempat operasi pemulihan terjadi.

System.String[]

Backup-SqlDatabase

Bagikan melalui

Restore-SqlDatabase

Sintaks

Deskripsi

Contoh

Contoh 1: Memulihkan database dari file cadangan pada berbagi jaringan

Contoh 2: Memulihkan log transaksi database

Contoh 3: Memulihkan database dan meminta kata sandi

Contoh 4: Memulihkan log transaksi dengan opsi NORECOVERY

Contoh 5: Memulihkan rekaman log transaksi hingga titik waktu tertentu

Contoh 6: Memulihkan database dan merelokasi data dan file log

Contoh 7: Memulihkan database dari pita

Contoh 8: Memulihkan database dari layanan Azure Blob Storage

Contoh 9: Cadangkan database di SQL2016 dan pulihkan di SQL2017 menggunakan -AutoRelocateFile

Parameter

-AccessToken

-AutoRelocateFile

-BackupDevice

-BackupFile

-BlockSize

-BufferCount

-Checksum

-ClearSuspectPageTable

-Confirm

-ConnectionTimeout

-ContinueAfterError

-Credential

-Database

-DatabaseFile

-DatabaseFileGroup

-DatabaseObject

-Encrypt

-FileNumber

-HostNameInCertificate

-InputObject

-KeepReplication

-MaxTransferSize

-MediaName

-NoRecovery

-NoRewind

-Offset

-Partial

-PassThru

-Path

-ProgressAction

-RelocateFile

-ReplaceDatabase

-Restart

-RestoreAction

-RestrictedUser

-Script

-ServerInstance

-SqlCredential

-StandbyFile

-StopAtMarkAfterDate

-StopAtMarkName

-StopBeforeMarkAfterDate

-StopBeforeMarkName

-ToPointInTime

-TrustServerCertificate

-UnloadTapeAfter

-WhatIf

Input

Link Terkait

Saran dan Komentar

Sumber Daya Tambahan: