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
Perintah ini memulihkan MainDB database lengkap dari file \\mainserver\databasebackup\MainDB.trn ke instans server Computer\Instance, menggunakan sa SQL login.
Perintah ini akan meminta kata sandi untuk menyelesaikan autentikasi.
Contoh 4: Memulihkan log transaksi dengan opsi 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
Contoh ini memulihkan MainDB database lengkap 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 ini memulihkan database MainDB 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 dari cmdlet Restore-SqlDatabase .
Contoh 8: Memulihkan database dari layanan Azure Blob Storage
Perintah ini memulihkan MainDB database lengkap dari file pada layanan Windows Azure Blob Storage ke instans server Computer\Instance.
Parameter
-BackupDevice
Menentukan perangkat tempat cadangan disimpan.
Parameter ini tidak dapat digunakan dengan parameter BackupFile .
Gunakan parameter ini jika Anda mencadangkan ke perangkat 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 atau lokasi tempat file cadangan disimpan.
Parameter ini bersifat opsional.
Jika tidak ditentukan, lokasi cadangan default server dicari untuk nama database name.trn <>untuk pemulihan log, atau <nama> database.bak untuk semua jenis pemulihan lainnya.
Parameter ini tidak dapat digunakan dengan parameter BackupDevice .
Jika Anda mendukung layanan Windows Azure Blob Storage (URL), parameter ini atau parameter BackupDevice harus ditentukan.
Properti parameter
Jenis:
String[]
Nilai default:
None
Mendukung wildcard:
False
DontShow:
False
Set parameter
(All)
Position:
3
Wajib:
False
Nilai dari alur:
False
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
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.
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 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.
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 pemulihan.
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
-ClearSuspectPageTable
Menunjukkan bahwa tabel halaman tersangka dihapus setelah operasi pemulihan.
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
-Confirm
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
-Credential
Menentukan objek PSCredential yang berisi kredensial untuk login SQL Server yang memiliki izin untuk melakukan operasi ini.
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 dipulihkan.
Ini tidak dapat digunakan dengan parameter DatabaseObject .
Ketika parameter ini digunakan, parameter Path, InputObject, atau ServerInstance juga harus ditentukan.
Properti parameter
Jenis:
String
Nilai default:
None
Mendukung wildcard:
False
DontShow:
False
Set parameter
ByPath
Position:
2
Wajib:
True
Nilai dari alur:
False
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
False
ByObject
Position:
2
Wajib:
True
Nilai dari alur:
False
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
False
ByName
Position:
2
Wajib:
True
Nilai dari alur:
False
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
False
-DatabaseFile
Menentukan file database yang ditargetkan oleh operasi pemulihan.
Ini hanya digunakan ketika parameter RestoreAction diatur ke File.
Saat parameter RestoreAction diatur ke File, parameter DatabaseFileGroups atau DatabaseFiles juga 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 pemulihan.
Ini hanya digunakan ketika parameter RestoreAction diatur ke File.
Saat parameter RestoreAction diatur ke File, parameter DatabaseFileGroups atau DatabaseFiles juga 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 pemulihan.
Properti parameter
Jenis:
Database
Nilai default:
None
Mendukung wildcard:
False
DontShow:
False
Set parameter
ByDBObject
Position:
2
Wajib:
True
Nilai dari alur:
True
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
False
-FileNumber
Menentukan nomor indeks yang digunakan untuk mengidentifikasi kumpulan cadangan yang ditargetkan pada media cadangan.
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
-InputObject
Menentukan objek server instans SQL Server tempat pemulihan terjadi.
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
-KeepReplication
Menunjukkan bahwa konfigurasi replikasi dipertahankan.
Jika tidak diatur, konfigurasi replikasi diabaikan oleh operasi pemulihan.
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
-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
-MediaName
Menentukan nama yang 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
-NoRecovery
Menunjukkan bahwa database dipulihkan ke status pemulihan.
Operasi gulung balik tidak terjadi dan cadangan tambahan dapat dipulihkan.
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 pemulihan selesai.
Jika tidak diatur, pita digabungkan kembali setelah operasi selesai.
Ini tidak berlaku untuk pemulihan 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
-Offset
Menentukan alamat halaman yang akan dipulihkan.
Ini hanya digunakan ketika parameter RestoreAction diatur ke OnlinePage.
Properti parameter
Jenis:
Int64[]
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
-Partial
Menunjukkan bahwa operasi pemulihan adalah pemulihan parsial.
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 ini menghasilkan objek Smo.Backup yang digunakan untuk melakukan operasi pemulihan.
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 instans SQL Server tempat menjalankan operasi pemulihan.
Parameter ini bersifat opsional.
Jika tidak ditentukan, lokasi kerja saat ini digunakan.
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
-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.
Properti parameter
Jenis:
RelocateFile[]
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
-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.
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
-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.
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
-RestoreAction
Menentukan jenis operasi pemulihan yang dilakukan.
Nilai yang valid adalah:
Database
Database dipulihkan.
File.
Satu atau beberapa file data dipulihkan.
Parameter DatabaseFile atau DatabaseFileGroup harus ditentukan.
Batang.
Log penerjemahan dipulihkan.
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.
Properti parameter
Jenis:
RestoreActionType
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
-RestrictedUser
Menunjukkan bahwa akses ke database yang dipulihkan dibatasi untuk peran database tetap db_owner, dan peran server tetap dbcreator dan sysadmin.
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
-Script
Menunjukkan bahwa cmdlet ini menghasilkan skrip Transact-SQL yang melakukan operasi pemulihan.
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 pemulihan.
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
-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
-StandbyFile
Menentukan nama file urungkan yang digunakan sebagai bagian dari strategi pencitraan untuk instans SQL Server.
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
-StopAtMarkAfterDate
Menentukan tanggal yang akan digunakan dengan nama tanda yang ditentukan oleh parameter StopAtMarkName untuk menentukan titik penghentian operasi 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
-StopAtMarkName
Menentukan transaksi yang ditandai untuk menghentikan operasi pemulihan.
Ini digunakan dengan parameter StopAtMarkAfterDate untuk menentukan titik penghentian 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.
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
-StopBeforeMarkAfterDate
Menentukan tanggal yang akan digunakan dengan parameter StopBeforeMarkName untuk menentukan titik penghentian operasi 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
-StopBeforeMarkName
Menentukan transaksi yang ditandai sebelumnya untuk menghentikan operasi pemulihan.
Ini digunakan dengan parameter StopBeforeMarkAfterDate untuk menentukan titik penghentian operasi 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
-ToPointInTime
Menentukan titik akhir untuk pemulihan log database.
Ini hanya berlaku ketika parameter RestoreAction diatur ke Log.
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 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.
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.
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
Menentukan SMO. Objek server yang menjelaskan instans SQL Server tempat operasi pemulihan terjadi.