Restore-AzSqlDatabase
Restaura una Base de datos SQL.
Syntax
Restore-AzSqlDatabase
[-FromPointInTimeBackup]
-PointInTime <DateTime>
-ResourceId <String>
-ServerName <String>
-TargetDatabaseName <String>
[-Edition <String>]
[-ServiceObjectiveName <String>]
[-ElasticPoolName <String>]
[-AsJob]
[-LicenseType <String>]
[-HAReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-ZoneRedundant]
[-Tag <Hashtable>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restore-AzSqlDatabase
[-FromPointInTimeBackup]
-PointInTime <DateTime>
-ResourceId <String>
-ServerName <String>
-TargetDatabaseName <String>
-Edition <String>
[-AsJob]
-ComputeGeneration <String>
-VCore <Int32>
[-LicenseType <String>]
[-HAReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-ZoneRedundant]
[-Tag <Hashtable>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restore-AzSqlDatabase
[-FromDeletedDatabaseBackup]
[-PointInTime <DateTime>]
-DeletionDate <DateTime>
-ResourceId <String>
-ServerName <String>
-TargetDatabaseName <String>
[-Edition <String>]
[-ServiceObjectiveName <String>]
[-ElasticPoolName <String>]
[-AsJob]
[-LicenseType <String>]
[-HAReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-ZoneRedundant]
[-Tag <Hashtable>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restore-AzSqlDatabase
[-FromDeletedDatabaseBackup]
[-PointInTime <DateTime>]
-DeletionDate <DateTime>
-ResourceId <String>
-ServerName <String>
-TargetDatabaseName <String>
-Edition <String>
[-AsJob]
-ComputeGeneration <String>
-VCore <Int32>
[-LicenseType <String>]
[-HAReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-ZoneRedundant]
[-Tag <Hashtable>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restore-AzSqlDatabase
[-FromGeoBackup]
-ResourceId <String>
-ServerName <String>
-TargetDatabaseName <String>
[-Edition <String>]
[-ServiceObjectiveName <String>]
[-ElasticPoolName <String>]
[-AsJob]
[-LicenseType <String>]
[-HAReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-ZoneRedundant]
[-Tag <Hashtable>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restore-AzSqlDatabase
[-FromGeoBackup]
-ResourceId <String>
-ServerName <String>
-TargetDatabaseName <String>
-Edition <String>
[-AsJob]
-ComputeGeneration <String>
-VCore <Int32>
[-LicenseType <String>]
[-HAReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-ZoneRedundant]
[-Tag <Hashtable>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restore-AzSqlDatabase
[-FromLongTermRetentionBackup]
-ResourceId <String>
-ServerName <String>
-TargetDatabaseName <String>
[-Edition <String>]
[-ServiceObjectiveName <String>]
[-ElasticPoolName <String>]
[-AsJob]
[-LicenseType <String>]
[-HAReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-ZoneRedundant]
[-Tag <Hashtable>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restore-AzSqlDatabase
[-FromLongTermRetentionBackup]
-ResourceId <String>
-ServerName <String>
-TargetDatabaseName <String>
-Edition <String>
[-AsJob]
-ComputeGeneration <String>
-VCore <Int32>
[-LicenseType <String>]
[-HAReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-ZoneRedundant]
[-Tag <Hashtable>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Restore-AzSqlDatabase restaura una base de datos SQL a partir de 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. También puede realizar una restauración entre suscripciones para una base de datos de datawarehouse.
Ejemplos
Ejemplo 1: Restauración de una base de datos desde un momento dado
$Database = Get-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
Restore-AzSqlDatabase -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
$Database = Get-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
Restore-AzSqlDatabase -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
$DeletedDatabase = Get-AzSqlDeletedDatabaseBackup -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
Restore-AzSqlDatabase -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-AzSqlDeletedDatabaseBackup. El segundo comando inicia la restauración a partir de la copia de seguridad de base de datos eliminada mediante el cmdlet Restore-AzSqlDatabase . 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
$DeletedDatabase = Get-AzSqlDeletedDatabaseBackup -ResourceGroupName $resourceGroupName -ServerName $sqlServerName -DatabaseName 'DatabaseToRestore'
Restore-AzSqlDatabase -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-AzSqlDeletedDatabaseBackup. El segundo comando inicia la restauración desde la copia de seguridad de base de datos eliminada mediante Restore-AzSqlDatabase. 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
$GeoBackup = Get-AzSqlDatabaseGeoBackup -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
Restore-AzSqlDatabase -FromGeoBackup -ResourceGroupName "TargetResourceGroup" -ServerName "TargetServer" -TargetDatabaseName "RestoredDatabase" -ResourceId $GeoBackup.ResourceID -Edition "Standard" -ServiceObjectiveName "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
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AssignIdentity
Genere y asigne una identidad de Microsoft Entra para esta base de datos para usarla con servicios de administración de claves como Azure KeyVault.
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackupStorageRedundancy
Redundancia de almacenamiento de copia de seguridad usada para almacenar copias de seguridad de SQL Database. Las opciones son: Local, Zone, Geo y GeoZone.
Tipo: | String |
valores aceptados: | Local, Zone, Geo, GeoZone |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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
Tipo: | String |
Aliases: | Family |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
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
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | DateTime |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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
- Básico
- Estándar
- Premium
- Datawarehouse
- Gratuito
- Stretch
- GeneralPurpose
- BusinessCritical
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncryptionProtector
Clave del protector de cifrado para SQL Database.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionProtectorAutoRotation
Estado de rotación automática de claves de AKV
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FederatedClientId
Identificador de cliente federado para SQL Database. Se usa para el escenario de CMK entre inquilinos.
Tipo: | Nullable<T>[Guid] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
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-AzSqlDeletedDatabaseBackup para obtener la copia de seguridad de una base de datos SQL eliminada.
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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-AzSqlDatabaseGeoBackup para obtener una copia de seguridad con redundancia geográfica.
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HAReplicaCount
Recuento de réplicas de alta disponibilidad que se usa para almacenar copias de seguridad de SQL Database.
Tipo: | Int32 |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KeyList
Lista de claves de AKV para SQL Database.
Tipo: | String[] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseType
Tipo de licencia para la base de datos de Azure Sql.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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 .
Tipo: | DateTime |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | String |
Position: | 0 |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
Especifica el identificador del recurso que se va a restaurar.
Tipo: | String |
Aliases: | Id |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServerName
Especifica el nombre del servidor de base de datos SQL.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceObjectiveName
Especifica el nombre del objetivo de servicio.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Etiquetas que se van a asociar a Azure Sql Database
Tipo: | Hashtable |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TargetDatabaseName
Especifica el nombre de la base de datos a la que se va a restaurar.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserAssignedIdentityId
Lista de identidades asignadas por el usuario para SQL Database.
Tipo: | String[] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VCore
Los números de núcleo virtual de la instancia restaurada de Azure Sql Database.
Tipo: | Int32 |
Aliases: | Capacity |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ZoneRedundant
Redundancia de zona que se va a asociar a Azure Sql Database. Esta propiedad solo se puede establecer para las bases de datos de edición de Hiperescala.
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Salidas
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de