Restore-SqlDatabase
Restaura una base de datos a partir de una copia de seguridad o registros de transacciones.
Syntax
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>]
Description
El cmdlet Restore-SqlDatabase realiza operaciones de restauración en una base de datos SQL Server. Esto incluye restauraciones de base de datos, restauraciones del registro de transacciones y restauraciones del archivo de base de datos.
Este cmdlet se modela después de la clase Microsoft.SqlServer.Management.Restore.Backup. 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 MainDB
completa del archivo \\mainserver\databasebackup\MainDB.bak
a la instancia Computer\Instance
del servidor .
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
desde el archivo \\mainserver\databasebackup\MainDB.trn
a la instancia Computer\Instance
del servidor .
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 MainDB
completa del archivo \\mainserver\databasebackup\MainDB.bak
a la instancia Computer\Instance
del servidor mediante el sa
inicio de sesión de SQL.
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 NORECOVERY
opción del archivo \\mainserver\databasebackup\MainDB.trn
a la instancia Computer\Instance
del servidor .
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 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 MainDB
completa a la instancia Computer\Instance
del servidor y 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 RelocateFile se pasan al parámetro RelocateFile del cmdlet Restore-SqlDatabase .
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 Computer\Instance
del servidor .
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 MainDB
completa desde el archivo del servicio windows Azure Blob Storage a la instancia Computer\Instance
del servidor .
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 -AutoRelocate , el cmdlet habría producido un error porque los archivos físicos en los que difieren, como se muestra en las dos tablas anteriores (además, lo más probable es que los archivos hubieran estado en uso por SQL2016 y posiblemente no se hubieran accesible por SQL2017). -AutoRelocate permitió al usuario evitar tener que usar explícitamente -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
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
usar o Service Principal
.Managed Identity
El parámetro que se va a usar puede ser una cadena que representa el token o un PSAccessToken
objeto tal como se devuelve mediante la ejecución Get-AzAccessToken -ResourceUrl https://database.windows.net
de .
Este parámetro es nuevo en la versión 22 del módulo.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoRelocateFile
Cuando se especifica este modificador, el cmdlet se encargará de reasignar automáticamente todos los archivos lógicos de la copia de seguridad, a menos que se especifique dicho archivo lógico con el archivo RelocateFile. El servidor DefaultFile y DefaultLog se usan para reubicar los archivos.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 va a realizar una copia de seguridad en un dispositivo de cinta.
Type: | BackupDeviceItem[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 el nombre <database name>.trn
de las restauraciones de registros en la ubicación de copia de seguridad predeterminada del servidor 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 de windows Azure Blob Storage (URL), se debe especificar este parámetro o el parámetro BackupDevice.
Type: | String[] |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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) bytes. El valor predeterminado es 65536 para dispositivos de cinta y 512 para todos los demás dispositivos.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BufferCount
Especifica el número total de búferes de E/S que se van a utilizar 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Checksum
Indica que se calcula un valor de suma de comprobación durante la operación de restauración.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearSuspectPageTable
Indica que la tabla de página sospechosa se elimina después de la operación de restauración.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionTimeout
Especifica el número de segundos que se esperarán a una conexión de servidor antes de que se produzca un error de tiempo de espera. El tiempo de espera debe ser un entero comprendido entre 0 y 65534. Si se especifica 0, los intentos de conexión no expiran.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueAfterError
Indica que la operación continúa cuando se produce un error de suma de comprobación. Si no se establece, la operación dará error cuando se produzca un error de suma de comprobación.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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, InputObject o ServerInstance .
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 se establece en Files. Cuando el parámetro RestoreAction se establece en Files, también se debe especificar el parámetro DatabaseFileGroups o DatabaseFiles .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseFileGroup
Especifica los grupos de archivos de base de datos de destino de la operación de restauración. Esto solo se usa cuando el parámetro RestoreAction se establece en File. Cuando el parámetro RestoreAction se establece en Files, también se debe especificar el parámetro DatabaseFileGroups o DatabaseFiles .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseObject
Especifica un objeto de base de datos para la operación de restauración.
Type: | Database |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Encrypt
Tipo de cifrado que se va a usar al conectarse a SQL Server.
Este valor se asigna a la Encrypt
propiedad SqlConnectionEncryptOption
del 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", lo que puede crear un cambio importante para los scripts existentes.
Este parámetro es nuevo en la versión 22 del módulo.
Type: | String |
Accepted values: | Mandatory, Optional, Strict |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostNameInCertificate
Nombre de host que se va a usar al 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 para conectarse a una instancia de SQL Server habilitada para forzar el cifrado.
Este parámetro es nuevo en la versión 22 del módulo.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifica el objeto de servidor de la instancia de SQL Server donde se produce la restauración.
Type: | Server[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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).
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaName
Especifica el nombre que identifica un conjunto de medios.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 rebobina una vez que se completa la operación. Esto no se aplica a las restauraciones de disco.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Offset
Especifica las direcciones de página que se van a restaurar. Esto solo se usa cuando RestoreAction se establece en OnlinePage.
Type: | Int64[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Partial
Indica que la operación de restauración es una restauración parcial.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Indica que este cmdlet genera el objeto Smo.Backup usado para realizar la operación de restauración.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RelocateFile
Especifica una lista de objetos de archivo Smo.Relocate. Cada objeto consta de un nombre de archivo de copia de seguridad lógica y una ubicación de sistema de archivos físico. La restauración mueve la base de datos restaurada en la ubicación física especificada en el servidor de destino.
Type: | RelocateFile[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RestoreAction
Especifica el tipo de operación de restauración que se realiza. Los valores válidos son:
- Base de datos Se restaura la base de datos.
- 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.
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
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Script
Indica que este cmdlet genera un script transact-SQL que realiza la operación de restauración.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerInstance
Especifica el nombre de una instancia de SQL Server. Esta instancia de servidor se convierte en el destino de la operación de restauración.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SqlCredential
Especifica un objeto de credencial 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 disco o cinta.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StopAtMarkName
Especifica la transacción marcada en la que se va a detener 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 valor StopAtMarkAfterDate , la recuperación se detiene en la primera marca con el nombre especificado.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ToPointInTime
Especifica el punto de conexión para la restauración del registro de base de datos. Esto solo se aplica cuando RestoreAction se establece en Log.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustServerCertificate
Indica si el canal se cifrará al pasar 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 y posteriores del módulo, el valor predeterminado será "$false", lo que puede crear un cambio importante para los scripts existentes.
Este parámetro es nuevo en la versión 22 del módulo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnloadTapeAfter
Indica que el dispositivo de cinta se vuelve a reproducir y descargar cuando se completa la operación. Si no se establece, no se intenta rebobinar ni descargar el medio de cinta. Esto no se aplica a las copias de seguridad de disco.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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[]