Backup-SqlDatabase

Referencia

Módulo:: SQLServer

Realiza copias de seguridad SQL Server objetos de base de datos.

Syntax

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-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>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-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>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-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>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-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>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <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>]

Description

El cmdlet Backup-SqlDatabase realiza operaciones de copia de seguridad en una base de datos de SQL Server.

Esto incluye copias de seguridad completa de base de datos, copias de seguridad del registro de transacciones y copias de seguridad del archivo de base de datos.

Este cmdlet se modela después de la clase Microsoft.SqlServer.Management.Smo.Backup.

El parámetro de esta clase generalmente se corresponde con las propiedades en ese objeto Smo.

Para realizar una copia de seguridad de una base de datos por ruta de acceso de la instancia del servidor y el nombre de la base de datos, especifique la ruta de acceso de la instancia del servidor en el parámetro Path y el nombre de la base de datos.

Para realizar una copia de seguridad de una base de datos mediante un objeto Smo.Server y un nombre de base de datos, especifique el objeto Smo.Server en el parámetro InputObject, ya sea directamente o mediante el operador de canalización, y el nombre de la base de datos en el parámetro Database.

Para realizar una copia de seguridad de una base de datos por instancia de servidor y nombre de base de datos, especifique la instancia del servidor en el parámetro ServerInstance y el nombre de la base de datos en el parámetro Database.

Para realizar una copia de seguridad de una base de datos mediante un objeto Smo.Database, especifique el objeto Smo.Database en el parámetro DatabaseObject, ya sea directamente o mediante el operador de canalización.

De forma predeterminada, este cmdlet realiza una copia de seguridad completa de la base de datos.

Establezca el tipo de la copia de seguridad mediante el parámetro BackupAction.

De forma predeterminada, el archivo de copia de seguridad se almacena en la ubicación predeterminada de copia de seguridad del servidor bajo el nombre databasename.bak para copias de seguridad completas o de archivos y bajo el nombre databasename.trn para las copias de seguridad de registros. Para especificar un nombre de archivo diferente, use el parámetro BackupFile.

Para especificar una ubicación de archivo de copia de seguridad y usar un nombre de archivo generado automáticamente, especifique la ubicación mediante el parámetro BackupContainer.

Ejemplos

Ejemplo 1: Copia de seguridad de una base de datos completa

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB"

Este comando crea una copia de seguridad completa de la base de datos denominada "MainDB" en la ubicación de copia de seguridad predeterminada de la instancia del servidor "Equipo\Instancia". El archivo de copia de seguridad se denomina "MainDB.bak".

Ejemplo 2: Copia de seguridad de una base de datos basada en la ubicación

PS C:\> Set-Location "SQLSERVER:\SQL\Computer\Instance" 
PS SQLSERVER:\SQL\Computer\Instance> Backup-SqlDatabase -Database "MainDB"

Este comando crea una copia de seguridad completa de la base de datos "MainDB" en la ubicación de copia de seguridad predeterminada de la instancia de servidor "Equipo\Instancia". El directorio de trabajo actual se usa para determinar la instancia del servidor donde se produce la copia de seguridad.

Ejemplo 3: Copia de seguridad del registro de transacciones

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Log

Este comando crea una copia de seguridad del registro de transacciones de la base de datos "MainDB" en la ubicación de copia de seguridad predeterminada de la instancia del servidor "Equipo\Instancia". El archivo de copia de seguridad se denomina "MainDB.trn".

Ejemplo 4: Copia de seguridad de una base de datos y solicitud de credenciales

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Credential (Get-Credential "sa")

Este comando crea una copia de seguridad completa de la base de datos "MainDB" mediante el inicio de sesión "sa" SQL Server. Este comando solicita una contraseña para completar la autenticación.

Ejemplo 5: Copia de seguridad de una base de datos en un recurso compartido de archivos de red

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

Este comando crea una copia de seguridad completa de la base de datos "MainDB" en el archivo "\\mainserver\databasebackup\MainDB.bak".

Ejemplo 6: Copia de seguridad de todas las bases de datos de una instancia de servidor

PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase

Este comando crea una copia de seguridad de todas las bases de datos en la instancia de servidor 'Computer\Instance' en la ubicación de copia de seguridad predeterminada. Los archivos de copia de seguridad se denominan <nombre> de base de datos.bak.

Ejemplo 7: Copia de seguridad de todas las bases de datos de una instancia de servidor en un recurso compartido de archivos de red

PS C:\> Set-Location "SQLSERVER:\SQL\Computer\Instance\Databases"
PS SQLSERVER:\SQL\Computer\Instance\Databases> foreach ($database in (Get-ChildItem)) {
     $dbName = $database.Name
     Backup-SqlDatabase -Database $dbName -BackupFile "\\mainserver\databasebackup\$dbName.bak" }

Este comando crea una copia de seguridad completa para cada base de datos de la instancia de servidor "Equipo\Instancia" en el recurso compartido "\\mainserver\databasebackup". Los archivos de copia de seguridad se denominan <nombre> de base de datos.bak.

Ejemplo 8: Copia de seguridad de todos los archivos en grupos de archivos secundarios

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Files -DatabaseFileGroup "FileGroupJan","FileGroupFeb"

Este comando crea una copia de seguridad de archivos completa de todos los archivos de los grupos de archivos secundarios "FileGroupJan" y "FileGroupFeb".

Ejemplo 9: Creación de una copia de seguridad diferencial

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Incremental

Este comando crea una copia de seguridad diferencial de la base de datos "MainDB" en la ubicación de copia de seguridad predeterminada de la instancia de servidor "Equipo\Instancia". El archivo de copia de seguridad se denomina "MainDB.bak".

Ejemplo 10: Creación de una copia de seguridad en una unidad de cinta

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

Este comando crea una copia de seguridad completa de la base de datos MainDB en el dispositivo de cinta "\\.\tape0". Para representar este dispositivo, el comando construye una instancia del objeto 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. Este objeto BackupDeviceItem se pasa al parámetro BackupDevice del cmdlet Backup-SqlDatabase .

Ejemplo 11: Copia de seguridad de una base de datos en el servicio Azure Blob Storage

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"

Este comando crea una copia de seguridad completa de la base de datos "MainDB" en el servicio windows Azure Blob Storage. Usa BackupContainer para especificar la ubicación (URL) del contenedor de blobs de Windows Azure. El nombre del archivo de copia de seguridad se genera automáticamente. El parámetro SqlCredential se usa para especificar el nombre de la credencial de SQL Server que almacena la información de autenticación.

Ejemplo 12: Copia de seguridad de una base de datos en el servicio Azure Blob Storage y especificación del nombre de archivo

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainyDB" -BackupFile "https://storageaccountname.blob.core.windows.net/containername/MainDB.bak" -SqlCredential "SQLCredentialName"

Este comando crea una copia de seguridad completa de la base de datos MainDB en el servicio windows Azure Blob Storage. Usa el parámetro BackupFile para especificar la ubicación (dirección URL) y el nombre del archivo de copia de seguridad. El parámetro SqlCredential se emplea para especificar el nombre de la credencial de SQL Server.

Ejemplo 13: Copia de seguridad de todas las bases de datos en el servicio Azure Blob Storage

PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"

Este comando realiza una copia de seguridad de todas las bases de datos de la instancia de servidor "Equipo\Instancia" en la ubicación del servicio de Windows Azure Blob Storage mediante el parámetro BackupContainer. Los nombres de los archivos de copia de seguridad se generan automáticamente.

Ejemplo 14: Creación de una copia de seguridad cifrada

PS C:\> $EncryptionOption = New-SqlBackupEncryptionOption -Algorithm Aes256 -EncryptorType ServerCertificate -EncryptorName "BackupCert"
PS C:\> Backup-SqlDatabase -ServerInstance "." -Database "MainDB" -BackupFile "MainDB.bak" -CompressionOption On -EncryptionOption $EncryptionOption

En este ejemplo se crean las opciones de cifrado y se usan como valor de parámetro en Backup-SqlDatabase para crear una copia de seguridad cifrada.

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

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

-BackupAction

Especifica el tipo de operación de copia de seguridad que se va a realizar. Los valores válidos son:

Base de datos Realiza una copia de seguridad de todos los archivos de datos de la base de datos.
Archivos. Realiza una copia de seguridad de los archivos de datos especificados en los parámetros DatabaseFile o DatabaseFileGroup.
Registro. Realiza una copia de seguridad del registro de transacciones.

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

-BackupContainer

Especifica la carpeta o ubicación donde el cmdlet almacena las copias de seguridad. Puede ser una carpeta en un disco o una dirección URL para un contenedor de blobs de Azure. Este parámetro puede ser útil cuando se hace copia de seguridad de varias bases de datos en una instancia determinada. Este parámetro no se puede usar con un parámetro BackupDevice. El parámetro BackupContainer no se puede usar con el parámetro BackupFile.

La ruta de acceso utilizada para especificar la ubicación debe terminar con una barra diagonal (/).

Type:	String
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 la copia de seguridad en una cinta.

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

-BackupFile

Especifica la ubicación y el nombre de archivo de la copia de seguridad. Se trata de un parámetro opcional. Si no se especifica, las copias de seguridad se almacenan en la ubicación de copia de seguridad predeterminada del servidor bajo el nombre databasename.bak para copias de seguridad completas y de archivos, o databasename.trn para las copias de seguridad de registros. Este parámetro no se puede usar con los parámetros BackupDevice o BackupContainer.

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

-BackupSetDescription

Especifica la descripción del conjunto de copia de seguridad. Este parámetro es opcional.

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

-BackupSetName

Especifica el nombre del conjunto de copia de seguridad.

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

-BlockSize

Especifica el tamaño de bloque físico para la copia de seguridad, en bytes. 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 de búferes de E/S que se van a usar 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 copia de seguridad.

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

-CompressionOption

Especifica las opciones de compresión para la operación de copia de seguridad.

Type:	BackupCompressionOptions
Accepted values:	Default, On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet. Le pide 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

-CopyOnly

Indica que la copia de seguridad es una copia de seguridad de solo copia. Una copia de seguridad de solo copia no afecta a la secuencia normal de las copias de seguridad convencionales programadas periódicamente.

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. Este no es el objeto de credencial de SQL que se usa para almacenar la información de autenticación internamente mediante SQL Server al acceder a recursos fuera de SQL Server.

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 de la que se va a realizar una copia de seguridad. Este parámetro no se puede usar con el parámetro DatabaseObject. Cuando se especifica 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 uno o varios archivos de base de datos de los que se va a realizar una copia de seguridad. Este parámetro solo se usa cuando BackupAction se establece en Files. Cuando BackupAction se establece en Files, 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 copia de seguridad. Este parámetro solo se usa cuando la propiedad BackupAction se establece en Files. Cuando el parámetro BackupAction se establece en Files, 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 el objeto de base de datos para la operación de copia de seguridad.

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

-EncryptionOption

Especifica las opciones de cifrado para la operación de copia de seguridad.

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

-ExpirationDate

Especifica la fecha y hora en que expira el conjunto de copia de seguridad y los datos de copia de seguridad ya no se consideran válidos. Esto solo se puede usar para los datos de copia de seguridad almacenados en dispositivos de disco o cinta. Los conjuntos de copia de seguridad anteriores a la fecha de expiración están disponibles para ser sobrescritos por una copia de seguridad posterior.

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

-FormatMedia

Indica que la cinta tiene formato como primer paso de la operación de copia de seguridad. Esto se aplica a una copia de seguridad de disco.

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

-Incremental

Indica que se realiza una copia de seguridad diferencial.

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

-Initialize

Indica que se inicializan los dispositivos asociados a la operación de copia de seguridad. Esto sobrescribe los conjuntos de copia de seguridad existentes en el medio y convierte esta copia de seguridad en el primer conjunto de copia de seguridad del medio.

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

-InputObject

Especifica el objeto de servidor para la ubicación de copia de seguridad.

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

-LogTruncationType

Especifica el comportamiento de truncamiento de las copias de seguridad de registros. Los valores válidos son:

-- TruncateOnly -- NoTruncate -- Truncate

El valor predeterminado es Truncate.

Type:	BackupTruncateLogType
Accepted values:	TruncateOnly, NoTruncate, Truncate
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

-MediaDescription

Especifica la descripción del medio que contiene el conjunto de copia de seguridad. Este parámetro es opcional.

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

-MediaName

Especifica el nombre usado para identificar el conjunto de medios.

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

-MirrorDevices

Especifica una matriz de objetos BackupDeviceList que se usa en la copia de seguridad reflejada.

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

-NoRecovery

Indica que no se realiza una copia de seguridad del final del registro. Cuando se restaura, la base de datos está en estado de restauración. Cuando no se establece, se hace la copia de seguridad del final del registro. Esto solo se aplica cuando el parámetro BackupAction se establece en Log.

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

-NoRewind

Indica que se deja abierta una unidad de cinta en la posición final cuando se completa la copia de seguridad. Cuando no se establece, la cinta se rebobina una vez que se completa la operación. Esto no se aplica a las copias de seguridad de discos o direcciones URL.

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

-PassThru

Indica que el cmdlet genera el objeto Smo.Backup que realizó la copia de seguridad.

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

-Path

Especifica la ruta de acceso a la instancia de SQL Server para ejecutar la operación de copia de seguridad. Se trata de un parámetro opcional. Si no se especifica, el valor del valor predeterminado de este parámetro es la ubicación de trabajo actual.

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

-Restart

Indica que el cmdlet continúa procesando una operación de copia de seguridad completada parcialmente. Si no se establece, el cmdlet reinicia una operación de copia de seguridad 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

-RetainDays

Especifica el número de días que deben transcurrir antes de que se pueda sobrescribir un conjunto de copia de seguridad. Esto solo se puede usar para los datos de copia de seguridad almacenados en dispositivos de disco o cinta.

Type:	Int32
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 copia de seguridad.

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 copia de seguridad.

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

-SkipTapeHeader

Indica que el encabezado de cinta no se lee.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

-StatementTimeout

Establezca el tiempo de espera (en segundos) para la operación de copia de seguridad.

Si el valor es 0 o no se especifica el parámetro StatementTimeout , la operación de restauración no va a expirar.

Type:	Int32
Position:	Named
Default value:	0
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

-UndoFileName

Especifica el nombre del archivo de deshacer utilizado para almacenar transacciones no confirmadas que se revierten durante la recuperación.

Type:	String
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 finaliza 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 discos o direcciones URL.

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. Muestra lo que sucedería si el cmdlet se ejecuta. 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

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

Especifica un SMO. Objeto de servidor que hace referencia a la instancia de SQL Server en la que se produce la operación de copia de seguridad.

System.String[]

Salidas

System.Object

Restore-SqlDatabase

Backup-SqlDatabase

Syntax

Description

Ejemplos

Ejemplo 1: Copia de seguridad de una base de datos completa

Ejemplo 2: Copia de seguridad de una base de datos basada en la ubicación

Ejemplo 3: Copia de seguridad del registro de transacciones

Ejemplo 4: Copia de seguridad de una base de datos y solicitud de credenciales

Ejemplo 5: Copia de seguridad de una base de datos en un recurso compartido de archivos de red

Ejemplo 6: Copia de seguridad de todas las bases de datos de una instancia de servidor

Ejemplo 7: Copia de seguridad de todas las bases de datos de una instancia de servidor en un recurso compartido de archivos de red

Ejemplo 8: Copia de seguridad de todos los archivos en grupos de archivos secundarios

Ejemplo 9: Creación de una copia de seguridad diferencial

Ejemplo 10: Creación de una copia de seguridad en una unidad de cinta

Ejemplo 11: Copia de seguridad de una base de datos en el servicio Azure Blob Storage

Ejemplo 12: Copia de seguridad de una base de datos en el servicio Azure Blob Storage y especificación del nombre de archivo

Ejemplo 13: Copia de seguridad de todas las bases de datos en el servicio Azure Blob Storage

Ejemplo 14: Creación de una copia de seguridad cifrada

Parámetros

-AccessToken

-BackupAction

-BackupContainer

-BackupDevice

-BackupFile

-BackupSetDescription

-BackupSetName

-BlockSize

-BufferCount

-Checksum

-CompressionOption

-Confirm

-ConnectionTimeout

-ContinueAfterError

-CopyOnly

-Credential

-Database

-DatabaseFile

-DatabaseFileGroup

-DatabaseObject

-Encrypt

-EncryptionOption

-ExpirationDate

-FormatMedia

-HostNameInCertificate

-Incremental

-Initialize

-InputObject

-LogTruncationType

-MaxTransferSize

-MediaDescription

-MediaName

-MirrorDevices

-NoRecovery

-NoRewind

-PassThru

-Path

-Restart

-RetainDays

-Script

-ServerInstance

-SkipTapeHeader

-SqlCredential

-StatementTimeout

-TrustServerCertificate

-UndoFileName

-UnloadTapeAfter

-WhatIf

Entradas

Salidas

Vínculos relacionados

Recursos adicionales