Restore-SqlDatabase

Ссылка

Модуль:: SQLServer

Восстанавливает базу данных из резервных копий или записей журнала транзакций.

Синтаксис

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>]
       [-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>]
       [-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>]
       [-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>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Описание

Командлет Restore-SqlDatabase выполняет операции восстановления в базе данных SQL Server. К ним относятся операции полного восстановления базы данных, восстановления журнала транзакций и восстановления файлов базы данных.

Этот командлет создан в соответствии с классом Microsoft.SqlServer.Management.Smo.Restore. Параметры этого командлета обычно соответствуют свойствам объекта Smo.Restore.

Примеры

Пример 1. Восстановление базы данных из файла резервной копии в сетевой папке

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

Эта команда восстанавливает полную базу данных MainDB из файла \\mainserver\databasebackup\MainDB.bak в экземпляр Computer\Instanceсервера .

Пример 2. Восстановление журнала транзакций базы данных

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

Эта команда восстанавливает журнал транзакций для базы данных MainDB из файла \\mainserver\databasebackup\MainDB.trn в экземпляр Computer\Instanceсервера .

Пример 3. Восстановление базы данных и запрос пароля

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

Эта команда восстанавливает полную базу данных MainDB из файла \\mainserver\databasebackup\MainDB.bak в экземпляр Computer\Instanceсервера с помощью sa имени входа SQL. Эта команда запросит пароль для завершения проверки подлинности.

Пример 4. Восстановление журнала транзакций с параметром NORECOVERY

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

Эта команда восстанавливает журнал транзакций базы данных MainDB с параметром NORECOVERY из файла \\mainserver\databasebackup\MainDB.trn в экземпляр Computer\Instanceсервера .

Пример 5. Восстановление записей журнала транзакций до точки во времени

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

Эта команда восстанавливает журнал транзакций базы данных MainDB до даты, переданной параметру ToPointInTime , 21 сентября 2017 г. 23:11.

Пример 6. Восстановление базы данных и перемещение файлов данных и журналов

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)

В этом примере выполняется восстановление полной базы данных MainDB на экземпляр Computer\Instanceсервера и перемещение файлов данных и журналов. Для каждого перемещаемого файла в примере создается экземпляр класса Microsoft.SqlServer.Management.Smo.MovedeFile. Каждый конструктор принимает два аргумента: логическое имя файла и физическое расположение файла на целевом сервере. Объекты RelocateFile передаются в параметр ПереместитьFile командлета Restore-SqlDatabase .

Пример 7. Восстановление базы данных с ленты

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

В этом примере база данных MainDB восстанавливается с ленточного устройства с именем \\.\tape0 на экземпляре Computer\Instanceсервера . Для представления этого устройства в примере создается экземпляр класса Microsoft.Sqlserver.Management.Smo.BackupDeviceItem. Конструктор принимает два аргумента: имя устройства резервного копирования и тип устройства резервного копирования. Затем этот объект BackupDeviceItem передается в параметр BackupDevice командлета Restore-SqlDatabase .

Пример 8. Восстановление базы данных из службы Хранилище BLOB-объектов Azure

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

Эта команда восстанавливает полную базу данных MainDB из файла в службе Windows Хранилище BLOB-объектов Azure в экземпляр Computer\Instanceсервера .

Пример 9. Резервное копирование базы данных на SQL2016 и восстановление на SQL2017 с помощью -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

Первая команда создает резервную копию базы данных AdventureWorks на экземпляре SQL2016, работающем на компьютере MYSERVER. Резервная копия сохраняется в папке C:\BAK2.

Тот же файл резервной копии используется во втором командлете для восстановления базы данных на экземпляре SQL2017, работающем на том же компьютере (MYSERVER). Обратите внимание, что без параметра -AutoRelocate командлет завершился бы ошибкой, так как физические файлы отличаются, как показано в двух таблицах выше (более того, скорее всего, файлы использовались бы SQL2016 и, возможно, недоступны для SQL2017). Параметр -AutoRelocate позволил пользователю избежать необходимости явно использовать -RelocationFile, аргумент для которого довольно мучен для сборки.

Примечание. Предполагается, что и экземпляр SQL2016, и экземпляр SQL2017 имеют доступ к папке C:\BAK2 .

Параметры

-AccessToken

Маркер доступа, используемый для проверки подлинности для SQL Server, в качестве альтернативы проверке подлинности пользователя или пароля или проверки подлинности Windows.

Его можно использовать, например, для подключения к SQL Azure DB и SQL Azure Managed Instance с помощью Service Principal или Managed Identity.

Используемый параметр может быть либо строкой, представляющей маркер, либо объектом, PSAccessToken возвращаемым при выполнении команды Get-AzAccessToken -ResourceUrl https://database.windows.net.

Этот параметр является новым в версии 22 модуля.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoRelocateFile

Если указан этот параметр, командлет позаботится об автоматическом перемещении всех логических файлов в резервной копии, если только такой логический файл не указан в параметре Переместитьфайл. Серверы DefaultFile и DefaultLog используются для перемещения файлов.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupDevice

Указывает устройства, на которых хранятся резервные копии. Этот параметр нельзя использовать с параметром BackupFile. Используйте этот параметр, если выполняется резервное копирование на ленточное устройство.

Type:	BackupDeviceItem[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupFile

Указывает расположение или расположение, в котором хранятся файлы резервных копий. Этот параметр является необязательным. Если не указано, в расположении резервной копии сервера по умолчанию выполняется поиск по имени <database name>.trn для восстановления журналов или <database name>.bak для всех других типов восстановления. Этот параметр нельзя использовать с параметром BackupDevice . При резервном копировании в службу windows Хранилище BLOB-объектов Azure (URL-адрес) необходимо указать этот параметр или параметр BackupDevice.

Type:	String[]
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BlockSize

Указывает размер физического блока для резервной копии в байтах. Поддерживаются размеры 512, 1024, 2048, 4096, 8192, 16 384, 32 768 и 65 536 байт (64 КБ). Значение по умолчанию — 65536 для ленточных устройств и 512 для всех остальных устройств.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BufferCount

Указывает общее число буферов ввода-вывода, которые будут использоваться для операции резервного копирования. Можно задать любое положительное целое число. Если в процессе Sqlservr.exe буферов недостаточно виртуального адресного пространства, вы получите ошибку нехватки памяти.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Checksum

Указывает, что во время операции восстановления вычисляется значение контрольной суммы.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearSuspectPageTable

Указывает, что подозрительная таблица страниц удаляется после операции восстановления.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionTimeout

Указывает время ожидания подключения к серверу в секундах до сбоя времени ожидания. Значение времени ожидания должно быть целым числом от 0 до 65 534. Если задано значение 0, время ожидания для попыток подключения не истекает.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinueAfterError

Указывает, что операция продолжается при возникновении ошибки контрольной суммы. Если не задано, выполнение операции завершится ошибкой после возникновения ошибки контрольной суммы.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Указывает объект PSCredential, содержащий учетные данные для имени входа SQL Server с разрешением на выполнение этой операции.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

Указывает имя восстанавливаемой базы данных. Его нельзя использовать с параметром DatabaseObject. При использовании этого параметра необходимо также указать параметры Path, InputObject или ServerInstance .

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseFile

Указывает файлы базы данных, на которые нацелена операция восстановления. Используется только в том случае, если для параметра RestoreAction задано значение Files. Если для параметра RestoreAction задано значение Files, необходимо также указать параметр DatabaseFileGroups или DatabaseFiles .

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseFileGroup

Указывает группы файлов базы данных, на которые нацелена операция восстановления. Используется только в том случае, если для параметра RestoreAction задано значение File. Если для параметра RestoreAction задано значение Files, необходимо также указать параметр DatabaseFileGroups или DatabaseFiles .

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseObject

Указывает объект базы данных для операции восстановления.

Type:	Database
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Encrypt

Тип шифрования, используемый при подключении к SQL Server.

Это значение сопоставляется со свойством EncryptSqlConnectionEncryptOption объекта SqlConnection драйвера Microsoft.Data.SqlClient.

В модуле версии 22 значение по умолчанию — Optional (для совместимости с версией 21). В версии 23 и более поздних версий модуля значением по умолчанию будет "Обязательно", что может привести к критическому изменению для существующих скриптов.

Этот параметр является новым в версии 22 модуля.

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FileNumber

Указывает номер индекса, используемый для идентификации целевого резервного набора данных на носителе резервного копирования.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameInCertificate

Имя узла используется для проверки TLS/SSL-сертификата SQL Server. Этот параметр необходимо передать, если экземпляр SQL Server включен для принудительного шифрования и вы хотите подключиться к экземпляру с помощью имени узла или shortname. Если этот параметр опущен, необходимо передать полное доменное имя (FQDN) в -ServerInstance для подключения к экземпляру SQL Server, включенного для принудительного шифрования.

Этот параметр является новым в версии 22 модуля.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Указывает объект сервера экземпляра SQL Server, в котором выполняется восстановление.

Type:	Server[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-KeepReplication

Указывает, что конфигурация репликации сохранена. Если не задано, то при операции восстановления конфигурация репликации не учитывается.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxTransferSize

Указывает максимальное число байтов, передаваемых между носителем резервной копии и экземпляром SQL Server. Поддерживаются значения, кратные 65 536 байтам (64 КБ), вплоть до 4 194 304 байт (4 МБ).

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaName

Указывает имя, идентифицирующее набор носителей.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRecovery

Указывает, что база данных восстановлена в состоянии восстановления. Операция отката не выполняется, и можно восстановить дополнительные резервные копии.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRewind

Указывает, что ленточный накопитель остается открытым в конечной позиции после завершения восстановления. Если не указано иное, после завершения операции лента перематывается. Это не относится к восстановлению диска.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Offset

Указывает адреса страниц, которые необходимо восстановить. Используется только в том случае, если для restoreAction задано значение OnlinePage.

Type:	Int64[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Partial

Указывает, что операция восстановления является частичной.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Указывает, что этот командлет выводит объект Smo.Backup, используемый для выполнения операции восстановления.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Указывает путь к экземпляру SQL Server, на котором выполняется операция восстановления. Этот параметр является необязательным. Если значение не указано, используется текущее рабочее расположение.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RelocateFile

Указывает список объектов файлов Smo.Relocate. Каждый объект содержит логическое имя файла резервной копии и физическое местоположение в файловой системе. При восстановлении восстановленная база данных перемещается в указанное физическое местоположение на целевом сервере.

Type:	RelocateFile[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplaceDatabase

Указывает, что создан новый образ базы данных. При этом все существующие базы данных будут перезаписаны с тем же именем. Если значение не задано, операция восстановления завершится ошибкой, если база данных с таким именем уже существует на сервере.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Restart

Указывает, что этот командлет возобновляет частично завершенную операцию восстановления. Если параметр не задан, командлет перезапускает прерванную операцию восстановления в начале резервного набора данных.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RestoreAction

Указывает тип выполняемой операции восстановления. Допустимые значения:

база данных; База данных восстановлена.
Файлы Восстанавливается один или несколько файлов данных. Необходимо указать параметр DatabaseFile или DatabaseFileGroup.
OnlinePage. Страница данных восстанавливается в сети, чтобы база данных оставалась доступной для пользователей.
OnlineFiles. Файлы данных восстанавливаются в сети, чтобы база данных оставалась доступной для пользователей. Необходимо указать параметр DatabaseFile или DatabaseFileGroup.
Журнала. Журнал транслакций восстанавливается.

Type:	RestoreActionType
Accepted values:	Database, Files, OnlinePage, OnlineFiles, Log
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RestrictedUser

Указывает, что доступ к восстановленной базе данных ограничен предопределенной ролью базы данных db_owner, а также предопределенными ролями сервера dbcreator и sysadmin.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

Указывает, что этот командлет выводит скрипт Transact-SQL, выполняющий операцию восстановления.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerInstance

Указывает имя экземпляра SQL Server. Этот экземпляр сервера становится целевым объектом операции восстановления.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SqlCredential

Указывает объект SQL Server учетных данных, в котором хранятся сведения о проверке подлинности. При резервном копировании в службу хранилища BLOB-объектов необходимо указать этот параметр. Хранимые сведения о проверке подлинности включают имя учетной записи хранения и связанные значения ключа доступа. Не указывайте этот параметр для диска или ленты.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StandbyFile

Указывает имя файла отмены, который используется в рамках стратегии создания образа для экземпляра SQL Server.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StopAtMarkAfterDate

Указывает дату, используемую с именем метки, заданной параметром StopAtMarkName для определения точки остановки операции восстановления.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StopAtMarkName

Указывает помеченную транзакцию, в которой следует остановить операцию восстановления. Он используется с StopAtMarkAfterDate для определения точки остановки операции восстановления. Восстановленные данные включают транзакцию, содержащую метку. Если значение StopAtMarkAfterDate не задано , восстановление останавливается на первой отметке с указанным именем.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StopBeforeMarkAfterDate

Указывает дату, используемую с Параметром StopBeforeMarkName для определения точки остановки операции восстановления.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StopBeforeMarkName

Указывает помеченную транзакцию, перед которой следует остановить операцию восстановления. Он используется с StopBeforeMarkAfterDate для определения точки остановки операции восстановления.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ToPointInTime

Указывает конечную точку для восстановления журнала базы данных. Это применимо только в том случае, если для свойства RestoreAction задано значение Log.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustServerCertificate

Указывает, будет ли канал зашифрован при обходе цепочки сертификатов для проверки доверия.

В модуле версии 22 значение по умолчанию — $true (для совместимости с версией 21). В модуле версии 23+ значение по умолчанию будет "$false", что может привести к критическому изменению для существующих скриптов.

Этот параметр является новым в версии 22 модуля.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnloadTapeAfter

Указывает, что ленточное устройство перематывалось и выгружалось после завершения операции. Если не задано, перемотка и выгрузка ленты не выполняются. Это не относится к резервным копиям дисков.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Входные данные

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

Указывает объект SMO. Объект сервера, описывающий экземпляр SQL Server, на котором выполняется операция восстановления.

System.String[]

Backup-SqlDatabase

Restore-SqlDatabase

Синтаксис

Описание

Примеры

Пример 1. Восстановление базы данных из файла резервной копии в сетевой папке

Пример 2. Восстановление журнала транзакций базы данных

Пример 3. Восстановление базы данных и запрос пароля

Пример 4. Восстановление журнала транзакций с параметром NORECOVERY

Пример 5. Восстановление записей журнала транзакций до точки во времени

Пример 6. Восстановление базы данных и перемещение файлов данных и журналов

Пример 7. Восстановление базы данных с ленты

Пример 8. Восстановление базы данных из службы Хранилище BLOB-объектов Azure

Пример 9. Резервное копирование базы данных на SQL2016 и восстановление на SQL2017 с помощью -AutoRelocateFile

Параметры

-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

-RelocateFile

-ReplaceDatabase

-Restart

-RestoreAction

-RestrictedUser

-Script

-ServerInstance

-SqlCredential

-StandbyFile

-StopAtMarkAfterDate

-StopAtMarkName

-StopBeforeMarkAfterDate

-StopBeforeMarkName

-ToPointInTime

-TrustServerCertificate

-UnloadTapeAfter

-WhatIf

Входные данные

Связанные ссылки

Дополнительные ресурсы