Restore-AzureRmSqlDatabase

  • Referencia
Módulo:
AzureRM.Sql

Restaura una Base de datos SQL.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

Restore-AzureRmSqlDatabase
       [-FromPointInTimeBackup]
       -PointInTime <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromPointInTimeBackup]
       -PointInTime <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromDeletedDatabaseBackup]
       [-PointInTime <DateTime>]
       -DeletionDate <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromDeletedDatabaseBackup]
       [-PointInTime <DateTime>]
       -DeletionDate <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromGeoBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromGeoBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromLongTermRetentionBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromLongTermRetentionBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]

Description

El cmdlet Restore-AzureRmSqlDatabase restaura una base de datos SQL desde una copia de seguridad con redundancia geográfica, una copia de seguridad de una base de datos eliminada, una copia de seguridad de retención a largo plazo o un momento dado en una base de datos activa. La base de datos restaurada se crea como una nueva base de datos. Puede crear una base de datos SQL elástica estableciendo el parámetro ElasticPoolName en un grupo elástico existente.

Ejemplos

Ejemplo 1: Restauración de una base de datos desde un momento dado

PS C:\>$Database = Get-AzureRmSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
PS C:\> Restore-AzureRmSqlDatabase -FromPointInTimeBackup -PointInTime UTCDateTime -ResourceGroupName $Database.ResourceGroupName -ServerName $Database.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $Database.ResourceID -Edition "Standard" -ServiceObjectiveName "S2"

El primer comando obtiene la base de datos SQL denominada Database01 y, a continuación, la almacena en la variable $Database. El segundo comando restaura la base de datos en $Database desde la copia de seguridad a un momento dado especificada en la base de datos denominada RestoreDatabase.

Ejemplo 2: Restauración de una base de datos desde un momento dado a un grupo elástico

PS C:\>$Database = Get-AzureRmSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
PS C:\> Restore-AzureRmSqlDatabase -FromPointInTimeBackup -PointInTime UTCDateTime -ResourceGroupName $Database.ResourceGroupName -ServerName $Database.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $Database.ResourceID -ElasticPoolName "ElasticPool01"

El primer comando obtiene la base de datos SQL denominada Database01 y, a continuación, la almacena en la variable $Database. El segundo comando restaura la base de datos en $Database desde la copia de seguridad a un momento dado especificada en la base de datos SQL denominada RestoreDatabase en el grupo elástico denominado elasticpool01.

Ejemplo 3: Restauración de una base de datos eliminada

PS C:\>$DeletedDatabase = Get-AzureRmSqlDeletedDatabaseBackup -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
PS C:\> Restore-AzureRmSqlDatabase -FromDeletedDatabaseBackup -DeletionDate $DeletedDatabase.DeletionDate -ResourceGroupName $DeletedDatabase.ResourceGroupName -ServerName $DeletedDatabase.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $DeletedDatabase.ResourceID -Edition "Standard" -ServiceObjectiveName "S2" -PointInTime UTCDateTime

El primer comando obtiene la copia de seguridad de base de datos eliminada que desea restaurar mediante Get-AzureRmSqlDeletedDatabaseBackup. El segundo comando inicia la restauración a partir de la copia de seguridad de base de datos eliminada mediante el cmdlet Restore-AzureRmSqlDatabase . Si no se especifica el parámetro -PointInTime, la base de datos se restaurará a la hora de eliminación.

Ejemplo 4: Restauración de una base de datos eliminada en un grupo elástico

PS C:\>$DeletedDatabase = Get-AzureRmSqlDeletedDatabaseBackup -ResourceGroupName $resourceGroupName -ServerName $sqlServerName -DatabaseName 'DatabaseToRestore'
PS C:\> Restore-AzureRmSqlDatabase -FromDeletedDatabaseBackup -DeletionDate $DeletedDatabase.DeletionDate -ResourceGroupName $DeletedDatabase.ResourceGroupName -ServerName $DeletedDatabase.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $DeletedDatabase.ResourceID -ElasticPoolName "elasticpool01" -PointInTime UTCDateTime

El primer comando obtiene la copia de seguridad de base de datos eliminada que desea restaurar mediante Get-AzureRmSqlDeletedDatabaseBackup. El segundo comando inicia la restauración a partir de la copia de seguridad de base de datos eliminada mediante Restore-AzureRmSqlDatabase. Si no se especifica el parámetro -PointInTime, la base de datos se restaurará a la hora de eliminación.

Ejemplo 5: Restauración geográfica de una base de datos

PS C:\>$GeoBackup = Get-AzureRmSqlDatabaseGeoBackup -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
PS C:\> Restore-AzureRmSqlDatabase -FromGeoBackup -ResourceGroupName "TargetResourceGroup" -ServerName "TargetServer" -TargetDatabaseName "RestoredDatabase" -ResourceId $GeoBackup.ResourceID -Edition "Standard" -RequestedServiceObjectiveName "S2"

El primer comando obtiene la copia de seguridad con redundancia geográfica de la base de datos denominada Database01 y, a continuación, la almacena en la variable $GeoBackup. El segundo comando restaura la copia de seguridad en $GeoBackup a la base de datos SQL denominada RestoreDatabase.

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

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

-ComputeGeneration

Generación de proceso que se va a asignar a la base de datos restaurada

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeletionDate

Especifica la fecha de eliminación como un objeto DateTime . Para obtener un objeto DateTime , use el cmdlet Get-Date.

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

-Edition

Especifica la edición de la base de datos SQL. Los valores permitidos para este parámetro son los siguientes:

  • None
  • Basic
  • Estándar
  • Premium
  • Datawarehouse
  • Gratuito
  • Stretch
  • GeneralPurpose
  • BusinessCritical
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ElasticPoolName

Especifica el nombre del grupo elástico en el que se va a colocar la base de datos SQL.

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

-FromDeletedDatabaseBackup

Indica que este cmdlet restaura una base de datos a partir de una copia de seguridad de una base de datos SQL eliminada. Puede usar el cmdlet Get-AzureRMSqlDeletedDatabaseBackup para obtener la copia de seguridad de una base de datos SQL eliminada.

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

-FromGeoBackup

Indica que este cmdlet restaura una base de datos SQL a partir de una copia de seguridad con redundancia geográfica. Puede usar el cmdlet Get-AzureRMSqlDatabaseGeoBackup para obtener una copia de seguridad con redundancia geográfica.

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

-FromLongTermRetentionBackup

Indica que este cmdlet restaura una base de datos SQL a partir de una copia de seguridad de retención a largo plazo.

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

-FromPointInTimeBackup

Indica que este cmdlet restaura una base de datos SQL desde una copia de seguridad a un momento dado.

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

-LicenseType

Tipo de licencia para la base de datos de Azure Sql.

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

-PointInTime

Especifica el momento dado, como un objeto DateTime , al que desea restaurar la base de datos SQL. Para obtener un objeto DateTime , use el cmdlet Get-Date . Use este parámetro junto con el parámetro FromPointInTimeBackup .

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

-ResourceGroupName

Especifica el nombre del grupo de recursos al que este cmdlet asigna la base de datos SQL.

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

-ResourceId

Especifica el identificador del recurso que se va a restaurar.

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

-ServerName

Especifica el nombre del servidor de base de datos SQL.

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

-ServiceObjectiveName

Especifica el nombre del objetivo de servicio.

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

-TargetDatabaseName

Especifica el nombre de la base de datos a la que se va a restaurar.

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

-VCore

Los números de núcleo virtual de la instancia restaurada de Azure Sql Database.

Type:Int32
Aliases:Capacity
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

DateTime

String

Salidas

AzureSqlDatabaseModel