Backup-SqlDatabase

  • Referencia
Módulo:
SQLServer

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

Sintaxis

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>]
      [-ProgressAction <ActionPreference>]
      [-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>]
      [-ProgressAction <ActionPreference>]
      [-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>]
      [-ProgressAction <ActionPreference>]
      [-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>]
      [-ProgressAction <ActionPreference>]
      [-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>]
      [-ProgressAction <ActionPreference>]
      [-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 completas de bases de datos, copias de seguridad del registro de transacciones y copias de seguridad de archivos de base de datos.

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

Los parámetros de esta clase suelen corresponder a las propiedades de ese objeto Smo.

Para realizar una copia de seguridad de una base de datos por ruta de acceso de 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 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 "Computer\Instance". 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 de SQL Server "sa". 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 realiza una copia de seguridad de todas las bases de datos de la instancia de servidor "Equipo\Instancia" 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 "Computer\Instance" 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 "Computer\Instance". El archivo de copia de seguridad se denomina "MainDB.bak".

Ejemplo 10: Crear 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 (URL) y el nombre del archivo de copia de seguridad. El parámetro SqlCredential se usa 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 "Computer\Instance" en la ubicación del servicio De almacenamiento de blobs de Windows Azure mediante el parámetro BackupContainer. Los nombres de archivo 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 un valor de parámetro en backup-SqlDatabase para crear una copia de seguridad cifrada.

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

-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.
Tipo:BackupActionType
Valores aceptados:Database, Files, Log
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 al realizar copias 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 (/).

Tipo:String
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 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 y los nombres 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.

Al realizar una copia de seguridad en varios archivos, separe los nombres de archivo con comas, por ejemplo: -BackupFile C:\Backups\databasename2.bak,C:\Backups\databasename2.bak

Este parámetro no se puede usar con los parámetros -BackupDevice o -BackupContainer.

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

-BackupSetDescription

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

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

-BackupSetName

Especifica el nombre del conjunto de copia de seguridad.

Tipo:String
Posición:Named
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 para la copia de seguridad, en bytes. 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 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.

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

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

-CompressionOption

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

Tipo:BackupCompressionOptions
Valores aceptados:Default, On, Off
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. 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

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

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

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 de la que se va a realizar la 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.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

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 copia de seguridad. Este parámetro solo se usa cuando la propiedad BackupAction está establecida en Files. Cuando el parámetro BackupAction se establece en Files, 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 el objeto de base de datos para la operación de copia de seguridad.

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

-EncryptionOption

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

Tipo:BackupEncryptionOptions
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 sobrescribirlos en una copia de seguridad posterior.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

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

-Incremental

Indica que se realiza una copia de seguridad diferencial.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 hace que esta copia de seguridad sea el primer conjunto de copia de seguridad en el medio.

Tipo:SwitchParameter
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 para la ubicación de copia de seguridad.

Tipo:Server[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:BackupTruncateLogType
Valores aceptados:TruncateOnly, NoTruncate, Truncate
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

-MediaDescription

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

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

-MediaName

Especifica el nombre usado para identificar el conjunto de medios.

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

-MirrorDevices

Especifica una matriz de objetos BackupDeviceList usados por la copia de seguridad reflejada.

Tipo:BackupDeviceList[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 realiza una copia de seguridad del final del registro. Esto solo se aplica cuando el parámetro BackupAction se establece en Log.

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 copia de seguridad. Cuando no se establece, la cinta se rewound una vez completada la operación. Esto no se aplica a las copias de seguridad de discos o direcciones URL.

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

-PassThru

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

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 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 de este parámetro tiene como valor predeterminado 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

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

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

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

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

-SkipTapeHeader

Indica que el encabezado de cinta no se lee.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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

-StatementTimeout

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

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

Tipo:Int32
Posición:Named
Valor predeterminado:0
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

-UndoFileName

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

Tipo:String
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 reproducir y descargar cuando finaliza 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 discos o direcciones URL.

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

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