Restore-SqlDatabase

Modul:

SqlServer Module

Memulihkan database dari rekaman log cadangan atau transaksi.

Sintaks

ByPath (Default)

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

ByName

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -ServerInstance <String[]>
    [-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>]
    [-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

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

Restore-SqlDatabase
    [-DatabaseObject] <Database>
    [[-BackupFile] <String[]>]
    [-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>]
    [-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 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 database MainDB lengkap dari file \\mainserver\databasebackup\MainDB.bak ke instans Computer\Instanceserver .

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 Computer\Instanceserver .

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 database MainDB lengkap dari file \\mainserver\databasebackup\MainDB.bak ke instans Computer\Instanceserver , menggunakan sa login SQL. 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 NORECOVERY opsi dari file \\mainserver\databasebackup\MainDB.trn ke instans Computer\Instanceserver .

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 MainDB hingga tanggal yang diteruskan ke parameter ToPointInTime , Sep 21, 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 MainDB lengkap ke instans Computer\Instanceserver , 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 database MainDB dari perangkat pita bernama \\.\tape0 ke instans Computer\Instanceserver . 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

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

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

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 di MYSERVER komputer. 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 harus eksplisit 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 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

-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.

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

-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 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.

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

-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:	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 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:	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

-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

-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

-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 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.
• 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.

Properti parameter

Jenis:	RestoreActionType
Nilai default:	None
Nilai yang diterima:	Database, Files, OnlinePage, OnlineFiles, 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

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

-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

-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

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

Link Terkait

• Backup-SqlDatabase