Restore-SqlDatabase

Referencia

Módulo:: SQLServer

Restaura una base de datos a partir de una copia de seguridad o registros de transacciones.

Sintaxis

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

Description

El cmdlet Restore-SqlDatabase realiza operaciones de restauración en una base de datos de SQL Server. Esto incluye restauraciones completas de bases de datos, restauraciones del registro de transacciones y restauraciones de archivos de base de datos.

Este cmdlet se modela después de la clase Microsoft.SqlServer.Management.Smo.Restore. Los parámetros de este cmdlet suelen corresponder a las propiedades del objeto Smo.Restore.

Ejemplos

Ejemplo 1: Restauración de una base de datos a partir de un archivo de copia de seguridad en un recurso compartido de red

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

Este comando restaura la base de datos completa MainDB del archivo \\mainserver\databasebackup\MainDB.bak a la instancia del servidor Computer\Instance.

Ejemplo 2: Restauración de un registro de transacciones de base de datos

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

Este comando restaura el registro de transacciones de la base de datos MainDB del archivo \\mainserver\databasebackup\MainDB.trn a la instancia del servidor Computer\Instance.

Ejemplo 3: Restaurar una base de datos y solicitar una contraseña

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

Este comando restaura la base de datos completa MainDB desde el archivo \\mainserver\databasebackup\MainDB.bak a la instancia del servidor Computer\Instance, mediante el inicio de sesión de SQL de sa. Este comando le pedirá una contraseña para completar la autenticación.

Ejemplo 4: Restauración de un registro de transacciones con la opción NORECOVERY

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

Este comando restaura el registro de transacciones de la base de datos MainDB con la opción NORECOVERY del archivo \\mainserver\databasebackup\MainDB.trn a la instancia del servidor Computer\Instance.

Ejemplo 5: Restauración de registros de transacciones hasta un momento dado

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

Este comando restaura el registro de transacciones de la base de datos MainDB hasta la fecha pasada al parámetro de ToPointInTime, 21 de septiembre de 2017 11:11 p. m.

Ejemplo 6: Restauración de una base de datos y reubicación de los archivos de datos y de registro

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)

En este ejemplo se restaura la base de datos completa MainDB a la instancia del servidor Computer\Instancey se reubican los archivos de datos y de registro. Para cada archivo que se mueve, el ejemplo construye una instancia de la clase Microsoft.SqlServer.Management.Smo.RelocateFile. Cada constructor toma dos argumentos, el nombre lógico del archivo y la ubicación física donde se colocará el archivo en el servidor de destino. Los objetos de RelocateFile se pasan al parámetro RelocateFile del cmdlet Restore-SqlDatabase de .

Ejemplo 7: Restauración de una base de datos a partir de cinta

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

En este ejemplo se restaura la base de datos MainDB desde el dispositivo de cinta denominado \\.\tape0 a la instancia del servidor Computer\Instance. Para representar este dispositivo, el ejemplo construye una instancia de la clase Microsoft.Sqlserver.Management.Smo.BackupDeviceItem. El constructor toma dos argumentos, el nombre del dispositivo de copia de seguridad y el tipo del dispositivo de copia de seguridad. A continuación, este objeto BackupDeviceItem se pasa al parámetro BackupDevice del cmdlet restore-SqlDatabase .

Ejemplo 8: Restauración de una base de datos desde el servicio Azure Blob Storage

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

Este comando restaura la base de datos completa MainDB desde el archivo del servicio Windows Azure Blob Storage a la instancia del servidor Computer\Instance.

Ejemplo 9: Copia de seguridad de una base de datos en SQL2016 y restauración en SQL2017 mediante -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

El primer comando realiza una copia de seguridad de la base de datos AdventureWorks en SQL2016 instancia que se ejecuta en la máquina MYSERVER. La copia de seguridad se guarda en C:\BAK2 .

El mismo archivo de copia de seguridad se usa en el segundo cmdlet para restaurar la base de datos en una instancia de SQL2017 que se ejecuta en la misma máquina (MYSERVER). Tenga en cuenta que, sin el modificador de -AutoRelocate, el cmdlet habría producido un error porque los archivos físicos donde son diferentes, como se muestra en las dos tablas anteriores (además, lo más probable es que SQL2016 SQL2016 y, posiblemente, no sea accesible por SQL2017). El -AutoRelocate permitió al usuario evitar tener que usar explícitamente el -RelocationFile, el argumento al que es bastante tedioso compilar.

Nota: se supone que tanto la instancia de SQL2016 como la instancia de SQL2017 tienen acceso a la carpeta C:\BAK2.

Parámetros

-AccessToken

El token de acceso que se usa para autenticarse en SQL Server, como alternativa a la autenticación de usuario o contraseña de Windows.

Esto se puede usar, por ejemplo, para conectarse a SQL Azure DB y SQL Azure Managed Instance mediante un Service Principal o un Managed Identity.

El parámetro que se va a usar puede ser una cadena que representa el token o un objeto PSAccessToken tal como se devuelve mediante la ejecución de Get-AzAccessToken -ResourceUrl https://database.windows.net.

Este parámetro es nuevo en la versión 22 del módulo.

Tipo:	PSObject
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AutoRelocateFile

Cuando se especifica este modificador, el cmdlet se encargará de reubicar automáticamente todos los archivos lógicos de la copia de seguridad, a menos que se especifique dicho archivo lógico con el RelocateFile. El servidor DefaultFile y DefaultLog se usan para reubicar los archivos.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BackupDevice

Especifica los dispositivos donde se almacenan las copias de seguridad. Este parámetro no se puede usar con el parámetro BackupFile. Use este parámetro si realiza una copia de seguridad en un dispositivo de cinta.

Tipo:	BackupDeviceItem[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BackupFile

Especifica la ubicación o las ubicaciones donde se almacenan los archivos de copia de seguridad. Este parámetro es opcional. Si no se especifica, se busca en la ubicación de copia de seguridad predeterminada del servidor el nombre <database name>.trn para las restauraciones de registros o <database name>.bak para todos los demás tipos de restauraciones. Este parámetro no se puede usar con el parámetro BackupDevice. Si va a realizar una copia de seguridad en el servicio Windows Azure Blob Storage (URL), debe especificarse este parámetro o el parámetro BackupDevice.

Tipo:	String[]
Posición:	2
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BlockSize

Especifica el tamaño de bloque físico, en bytes, para la copia de seguridad. Los tamaños admitidos son 512, 1024, 2048, 4096, 8192, 16384, 32768 y 65536 (64 KB). El valor predeterminado es 65536 para dispositivos de cinta y 512 para todos los demás dispositivos.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BufferCount

Especifica el número total de búferes de E/S que se usarán para la operación de copia de seguridad. Puede especificar cualquier entero positivo. Si no hay suficiente espacio de direcciones virtuales en el proceso de Sqlservr.exe para los búferes, recibirá un error de memoria insuficiente.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Checksum

Indica que se calcula un valor de suma de comprobación durante la operación de restauración.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClearSuspectPageTable

Indica que la tabla de página sospechosa se elimina después de la operación de restauración.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ConnectionTimeout

Especifica el número de segundos que se deben esperar a una conexión de servidor antes de un error de tiempo de espera. El valor de tiempo de espera debe ser un entero entre 0 y 65534. Si se especifica 0, los intentos de conexión no expiran.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ContinueAfterError

Indica que la operación continúa cuando se produce un error de suma de comprobación. Si no se establece, se producirá un error en la operación después de un error de suma de comprobación.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Credential

Especifica un objeto PSCredential que contiene las credenciales de un inicio de sesión de SQL Server que tiene permiso para realizar esta operación.

Tipo:	PSCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Database

Especifica el nombre de la base de datos que se va a restaurar. No se puede usar con el parámetro DatabaseObject. Cuando se usa este parámetro, también se deben especificar los parámetros Path, InputObjecto ServerInstance.

Tipo:	String
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DatabaseFile

Especifica los archivos de base de datos de destino de la operación de restauración. Esto solo se usa cuando el parámetro restoreAction de está establecido en Files. Cuando el parámetro RestoreAction se establece en Files, también se debe especificar el parámetro DatabaseFileGroups o DatabaseFiles.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DatabaseFileGroup

Especifica los grupos de archivos de base de datos destinados a la operación de restauración. Esto solo se usa cuando el parámetro RestoreAction está establecido en File. Cuando el parámetro RestoreAction se establece en Files, también se debe especificar el parámetro DatabaseFileGroups o DatabaseFiles.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DatabaseObject

Especifica un objeto de base de datos para la operación de restauración.

Tipo:	Database
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Encrypt

Tipo de cifrado que se va a usar al conectarse a SQL Server.

Este valor se asigna a la propiedad EncryptSqlConnectionEncryptOption en el objeto SqlConnection del controlador Microsoft.Data.SqlClient.

En la versión 22 del módulo, el valor predeterminado es Optional (por compatibilidad con v21). En la versión 23+ del módulo, el valor predeterminado será "Obligatorio", que puede crear un cambio importante para los scripts existentes.

Este parámetro es nuevo en la versión 22 del módulo.

Tipo:	String
Valores aceptados:	Mandatory, Optional, Strict
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FileNumber

Especifica el número de índice que se usa para identificar el conjunto de copia de seguridad de destino en el medio de copia de seguridad.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-HostNameInCertificate

Nombre de host que se va a usar para validar el certificado TLS/SSL de SQL Server. Debe pasar este parámetro si la instancia de SQL Server está habilitada para Forzar cifrado y desea conectarse a una instancia mediante el nombre de host o el nombre corto. Si se omite este parámetro, es necesario pasar el nombre de dominio completo (FQDN) a -ServerInstance es necesario para conectarse a una instancia de SQL Server habilitada para Forzar cifrado.

Este parámetro es nuevo en la versión 22 del módulo.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Especifica el objeto de servidor de la instancia de SQL Server donde se produce la restauración.

Tipo:	Server[]
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-KeepReplication

Indica que se conserva la configuración de replicación. Si no se establece, la operación de restauración omite la configuración de replicación.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MaxTransferSize

Especifica el número máximo de bytes que se van a transferir entre el medio de copia de seguridad y la instancia de SQL Server. Los valores posibles son múltiplos de 65536 bytes (64 KB), hasta 4194304 bytes (4 MB).

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MediaName

Especifica el nombre que identifica un conjunto de medios.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NoRecovery

Indica que la base de datos se restaura en el estado de restauración. No se produce una operación de reversión y se pueden restaurar copias de seguridad adicionales.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NoRewind

Indica que una unidad de cinta se deja abierta en la posición final cuando se completa la restauración. Si no se establece, la cinta se rewound una vez completada la operación. Esto no se aplica a las restauraciones de disco.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Offset

Especifica las direcciones de página que se van a restaurar. Esto solo se usa cuando RestoreAction está establecido en OnlinePage.

Tipo:	Int64[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Partial

Indica que la operación de restauración es una restauración parcial.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PassThru

Indica que este cmdlet genera el objeto Smo.Backup usado para realizar la operación de restauración.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Path

Especifica la ruta de acceso de la instancia de SQL Server en la que se va a ejecutar la operación de restauración. Este parámetro es opcional. Si no se especifica, se usa la ubicación de trabajo actual.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ProgressAction

Determina cómo Responde PowerShell a las actualizaciones de progreso generadas por un script, cmdlet o proveedor, como las barras de progreso generadas por el cmdlet Write-Progress. El cmdlet Write-Progress crea barras de progreso que muestran el estado de un comando.

Tipo:	ActionPreference
Alias:	proga
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RelocateFile

Especifica una lista de objetos de archivo Smo.Relocate. Cada objeto consta de un nombre de archivo de copia de seguridad lógico y una ubicación física del sistema de archivos. La restauración mueve la base de datos restaurada a la ubicación física especificada en el servidor de destino.

Tipo:	RelocateFile[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ReplaceDatabase

Indica que se crea una nueva imagen de la base de datos. Esto sobrescribe cualquier base de datos existente con el mismo nombre. Si no se establece, se producirá un error en la operación de restauración cuando ya exista una base de datos con ese nombre en el servidor.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Restart

Indica que este cmdlet reanuda una operación de restauración completada parcialmente. Si no se establece, el cmdlet reinicia una operación de restauración interrumpida al principio del conjunto de copia de seguridad.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RestoreAction

Especifica el tipo de operación de restauración que se realiza. Los valores válidos son:

Base de datos. La base de datos se restaura.
Archivos. Se restauran uno o varios archivos de datos. Se debe especificar el parámetro DatabaseFile o DatabaseFileGroup.
OnlinePage. Se restaura una página de datos en línea para que la base de datos permanezca disponible para los usuarios.
OnlineFiles. Los archivos de datos se restauran en línea para que la base de datos permanezca disponible para los usuarios. Se debe especificar el parámetro DatabaseFile o DatabaseFileGroup.
Registro. Se restaura el registro de translación.

Tipo:	RestoreActionType
Valores aceptados:	Database, Files, OnlinePage, OnlineFiles, Log
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RestrictedUser

Indica que el acceso a la base de datos restaurada está restringido al rol fijo de base de datos db_owner y los roles fijos de servidor dbcreator y sysadmin.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Script

Indica que este cmdlet genera un script de Transact-SQL que realiza la operación de restauración.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ServerInstance

Especifica el nombre de una instancia de SQL Server. Esta instancia del servidor se convierte en el destino de la operación de restauración.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-SqlCredential

Especifica un objeto de credencial de SQL Server que almacena información de autenticación. Si va a realizar una copia de seguridad en el servicio Blob Storage, debe especificar este parámetro. La información de autenticación almacenada incluye el nombre de la cuenta de almacenamiento y los valores de clave de acceso asociados. No especifique este parámetro para el disco o la cinta.

Tipo:	PSObject
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StandbyFile

Especifica el nombre de un archivo de deshacer que se usa como parte de la estrategia de creación de imágenes para una instancia de SQL Server.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StopAtMarkAfterDate

Especifica la fecha que se va a usar con el nombre de marca especificado por el parámetro StopAtMarkName para determinar el punto de detención de la operación de recuperación.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StopAtMarkName

Especifica la transacción marcada en la que se detendrá la operación de recuperación. Esto se usa con StopAtMarkAfterDate para determinar el punto de detención de la operación de recuperación. Los datos recuperados incluyen la transacción que contiene la marca. Si no se establece el StopAtMarkAfterDate, la recuperación se detiene en la primera marca con el nombre especificado.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StopBeforeMarkAfterDate

Especifica la fecha que se va a usar con StopBeforeMarkName para determinar el punto de detención de la operación de recuperación.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StopBeforeMarkName

Especifica la transacción marcada antes de la cual se detiene la operación de recuperación. Esto se usa con StopBeforeMarkAfterDate para determinar el punto de detención de la operación de recuperación.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ToPointInTime

Especifica el punto de conexión para la restauración del registro de base de datos. Esto solo se aplica cuando restoreAction está establecido en Registro.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TrustServerCertificate

Indica si el canal se cifrará mientras se pasa la cadena de certificados para validar la confianza.

En la versión 22 del módulo, el valor predeterminado es $true (por compatibilidad con v21). En la versión 23+ del módulo, el valor predeterminado será "$false", que puede crear un cambio importante para los scripts existentes.

Este parámetro es nuevo en la versión 22 del módulo.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UnloadTapeAfter

Indica que el dispositivo de cinta se vuelve a reenbinar y descargar cuando se completa la operación. Si no se establece, no se intenta rebobinar y descargar el medio de cinta. Esto no se aplica a las copias de seguridad de disco.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

Especifica un SMO. Objeto de servidor que describe la instancia de SQL Server en la que se produce la operación de restauración.

System.String[]

Backup-SqlDatabase

Compartir a través de

Restore-SqlDatabase

Sintaxis

Description

Ejemplos

Ejemplo 1: Restauración de una base de datos a partir de un archivo de copia de seguridad en un recurso compartido de red

Ejemplo 2: Restauración de un registro de transacciones de base de datos

Ejemplo 3: Restaurar una base de datos y solicitar una contraseña

Ejemplo 4: Restauración de un registro de transacciones con la opción NORECOVERY

Ejemplo 5: Restauración de registros de transacciones hasta un momento dado

Ejemplo 6: Restauración de una base de datos y reubicación de los archivos de datos y de registro

Ejemplo 7: Restauración de una base de datos a partir de cinta

Ejemplo 8: Restauración de una base de datos desde el servicio Azure Blob Storage

Ejemplo 9: Copia de seguridad de una base de datos en SQL2016 y restauración en SQL2017 mediante -AutoRelocateFile

Parámetros

-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

Entradas

Vínculos relacionados

Comentarios

Recursos adicionales