Start-AzureSqlDatabaseRestore

  • Referencia
Módulo:
Azure

Realiza una restauración a un momento dado de una base de datos.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

Start-AzureSqlDatabaseRestore
     [-SourceServerName <String>]
     -SourceDatabase <Database>
     [-TargetServerName <String>]
     -TargetDatabaseName <String>
     [-PointInTime <DateTime>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureSqlDatabaseRestore
     [-SourceServerName <String>]
     -SourceRestorableDroppedDatabase <RestorableDroppedDatabase>
     [-TargetServerName <String>]
     -TargetDatabaseName <String>
     [-PointInTime <DateTime>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureSqlDatabaseRestore
     -SourceServerName <String>
     -SourceDatabaseName <String>
     [-TargetServerName <String>]
     -TargetDatabaseName <String>
     [-PointInTime <DateTime>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureSqlDatabaseRestore
     -SourceServerName <String>
     -SourceDatabaseName <String>
     -SourceDatabaseDeletionDate <DateTime>
     [-TargetServerName <String>]
     [-RestorableDropped]
     -TargetDatabaseName <String>
     [-PointInTime <DateTime>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]

Description

El cmdlet Start-AzureSqlDatabaseRestore realiza una restauración a un momento dado de una base de datos Básica, Estándar o Premium. Azure SQL Database conserva copias de seguridad de base de datos básicas de 7 días, Estándar durante 14 días y Premium durante 35 días. La operación de restauración crea una nueva base de datos. Si no se elimina la base de datos de origen, el parámetro SourceDatabaseName y TargetDatabaseName deben tener valores diferentes.

Azure SQL Database no admite actualmente la restauración entre servidores. Los nombres de servidor de origen y de destino deben ser los mismos.

Ejemplos

Ejemplo 1: Restauración de una base de datos especificada como un objeto a un momento dado

PS C:\> $Database = Get-AzureSqlDatabase -ServerName "Server01" -DatabaseName "Database17" 
PS C:\> $Operation = Start-AzureSqlDatabaseRestore -SourceDatabase $Database -TargetDatabaseName "DatabaseRestored" -PointInTime "2013-01-01 06:00:00"

El primer comando obtiene un objeto de base de datos para la base de datos denominada Database17 en el servidor denominado Server01 y, a continuación, lo almacena en la variable $Database.

El segundo comando restaura la base de datos a un momento dado específico. El comando especifica en nombre para la nueva base de datos.

Ejemplo 2: Restauración de una base de datos especificada por nombre a un momento dado

PS C:\> $Operation = Start-AzureSqlDatabaseRestore -SourceServerName "Server01" -SourceDatabaseName "Database17" -TargetDatabaseName "DatabaseRestored" -PointInTime "2013-01-01 06:00:00"

Este comando restaura la base de datos denominada Database17 a un momento dado específico. El comando especifica en nombre para la nueva base de datos.

Ejemplo 3: Restauración de una base de datos quitada especificada como un objeto a un momento dado

PS C:\> $Database = Get-AzureSqlDatabase -RestorableDropped -ServerName "Server01" -DatabaseName "Database01" -DatabaseDeletionDate "2012-11-09T22:59:43.000Z" 
PS C:\> $Operation = Start-AzureSqlDatabaseRestore -SourceRestorableDroppedDatabase $Database -TargetDatabaseName "DroppedDatabaseRestored"

El primer comando obtiene un objeto de base de datos para la base de datos denominada Database01 en el servidor denominado Server01. El comando especifica el parámetro RestorableDropped . Por lo tanto, el cmdlet obtiene la base de datos restaurable quitada el punto de restauración especificado. El comando almacena ese objeto de base de datos en la variable $Database.

El segundo comando restaura la base de datos quitada especificada por $Database. El comando especifica en nombre para la nueva base de datos.

Parámetros

-PointInTime

Especifica el punto de restauración al que se va a restaurar la base de datos. Cuando finaliza la operación de restauración, la base de datos se restaura al estado que tenía en la fecha y hora en que especifica este parámetro. De forma predeterminada, para una base de datos activa, este conjunto se establece en la hora actual y para una base de datos eliminada, este cmdlet usa la hora en que se quitó la base de datos.

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

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

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

-RestorableDropped

Indica que este cmdlet restaura una base de datos quitada restaurable.

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

-SourceDatabase

Especifica el nombre de la base de datos que restaura este cmdlet.

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

-SourceDatabaseDeletionDate

Especifica la fecha y hora en que se eliminó la base de datos. Debe incluir milisegundos cuando especifique la hora para que coincida con el tiempo real de eliminación de la base de datos.

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

-SourceDatabaseName

Especifica el nombre de la base de datos activa que restaura este cmdlet.

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

-SourceRestorableDroppedDatabase

Especifica un objeto que representa la base de datos que se puede restaurar que restaura este cmdlet. Para obtener un objeto RestorableDroppedDatabase , use el cmdlet Get-AzureSqlDatabase y especifique el parámetro RestorableDropped .

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

-SourceServerName

Especifica el nombre del servidor en el que está activa y en ejecución la base de datos de origen, o en la que se ejecutó la base de datos de origen antes de eliminarla.

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

-TargetDatabaseName

Especifica el nombre de la nueva base de datos que crea la operación de restauración.

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

-TargetServerName

Especifica el nombre del servidor al que este cmdlet restaura la base de datos.

Azure SQL Database no admite actualmente la restauración entre servidores. Los nombres de servidor de origen y de destino deben ser los mismos.

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

Entradas

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.RestorableDroppedDatabase

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

Salidas

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.RestoreDatabaseOperation

Notas

  • Debe usar la autenticación basada en certificados para ejecutar este cmdlet. Ejecute los siguientes comandos en el equipo donde ejecute este cmdlet:

PS C:\\\> $subId = \<Subscription ID\> PS C:\\\> $thumbprint = \<Certificate Thumbprint\> PS C:\\\> $myCert = Get-Item Cert:\CurrentUser\My\$thumbprint PS C:\\\> Set-AzureSubscription -SubscriptionName "mySubscription" -SubscriptionId $subId -Certificate $myCert PS C:\\\> Select-AzureSubscription -SubscriptionName "mySubscription"