Restore-AzSqlDatabase
Restaura um banco de dados 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
O cmdlet Restore-AzSqlDatabase restaura um banco de dados SQL de um backup com redundância geográfica, um backup de um banco de dados excluído, um backup de retenção de longo prazo ou um point-in-time em um banco de dados ativo. O banco de dados restaurado é criado como um novo banco de dados. Você pode criar um banco de dados SQL elástico definindo o parâmetro ElasticPoolName como um pool elástico existente. Você também pode executar uma restauração de assinatura cruzada para um banco de dados de datawarehouse.
Exemplos
Exemplo 1: Restaurar um banco de dados de um point-in-time
$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"
O primeiro comando obtém o banco de dados SQL chamado Database01 e, em seguida, armazena-o na variável $Database. O segundo comando restaura o banco de dados em $Database do backup point-in-time especificado para o banco de dados chamado RestoredDatabase.
Exemplo 2: Restaurar um banco de dados de um point-in-time para um pool 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"
O primeiro comando obtém o banco de dados SQL chamado Database01 e, em seguida, armazena-o na variável $Database. O segundo comando restaura o banco de dados em $Database do backup point-in-time especificado para o banco de dados SQL chamado RestoredDatabase no pool elástico chamado elasticpool01.
Exemplo 3: Restaurar um banco de dados excluído
$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
O primeiro comando obtém o backup de banco de dados excluído que você deseja restaurar usando Get-AzSqlDeletedDatabaseBackup. O segundo comando inicia a restauração a partir do backup do banco de dados excluído usando o cmdlet Restore-AzSqlDatabase . Se o parâmetro -PointInTime não for especificado, o banco de dados será restaurado para o tempo de exclusão.
Exemplo 4: Restaurar um banco de dados excluído em um pool 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
O primeiro comando obtém o backup de banco de dados excluído que você deseja restaurar usando Get-AzSqlDeletedDatabaseBackup. O segundo comando inicia a restauração do backup do banco de dados excluído usando Restore-AzSqlDatabase. Se o parâmetro -PointInTime não for especificado, o banco de dados será restaurado para o tempo de exclusão.
Exemplo 5: Restauração geográfica de um banco de dados
$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"
O primeiro comando obtém o backup com redundância geográfica para o banco de dados chamado Database01 e, em seguida, o armazena na variável $GeoBackup. O segundo comando restaura o backup em $GeoBackup para o banco de dados SQL chamado RestoredDatabase.
Parâmetros
-AsJob
Executar cmdlet em segundo plano
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AssignIdentity
Gere e atribua uma identidade do Microsoft Entra para esse banco de dados para uso com serviços de gerenciamento de chaves, como o Azure KeyVault.
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackupStorageRedundancy
A redundância de armazenamento de backup usada para armazenar backups para o Banco de dados SQL. As opções são: Local, Zona, Geo e GeoZone.
Tipo: | String |
valores aceitos: | Local, Zone, Geo, GeoZone |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputeGeneration
A geração de computação a ser atribuída ao banco de dados restaurado
Tipo: | String |
Aliases: | Family |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeletionDate
Especifica a data de exclusão como um objeto DateTime . Para obter um objeto DateTime , use o cmdlet Get-Date.
Tipo: | DateTime |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Edition
Especifica a edição do banco de dados SQL. Os valores aceitáveis para esse parâmetro são:
- Nenhum
- Basic
- Standard
- Premium
- DataWarehouse
- Gratuita
- Stretch
- GeneralPurpose
- Comercialmente Crítico
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ElasticPoolName
Especifica o nome do pool elástico no qual colocar o banco de dados SQL.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncryptionProtector
A chave protetora de criptografia para o Banco de dados SQL.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionProtectorAutoRotation
O status de Rotação Automática de Chave AKV
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FederatedClientId
A ID do cliente federado para o Banco de Dados SQL. Ele é usado para o cenário de CMK entre locatários.
Tipo: | Nullable<T>[Guid] |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FromDeletedDatabaseBackup
Indica que esse cmdlet restaura um banco de dados de um backup de um banco de dados SQL excluído. Você pode usar o cmdlet Get-AzSqlDeletedDatabaseBackup para obter o backup de um banco de dados SQL excluído.
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FromGeoBackup
Indica que esse cmdlet restaura um banco de dados SQL de um backup com redundância geográfica. Você pode usar o cmdlet Get-AzSqlDatabaseGeoBackup para obter um backup com redundância geográfica.
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FromLongTermRetentionBackup
Indica que esse cmdlet restaura um banco de dados SQL de um backup de retenção de longo prazo.
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FromPointInTimeBackup
Indica que esse cmdlet restaura um banco de dados SQL de um backup point-in-time.
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HAReplicaCount
A Contagem de Réplicas de HA usada para armazenar backups do Banco de Dados SQL.
Tipo: | Int32 |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KeyList
A lista de chaves AKV para o Banco de Dados SQL.
Tipo: | String[] |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseType
O tipo de licença para o banco de dados SQL do Azure.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PointInTime
Especifica o point-in-time, como um objeto DateTime , para o qual você deseja restaurar seu banco de dados SQL. Para obter um objeto DateTime, use o cmdlet Get-Date. Use esse parâmetro junto com o parâmetro FromPointInTimeBackup .
Tipo: | DateTime |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Especifica o nome do grupo de recursos ao qual esse cmdlet atribui o banco de dados SQL.
Tipo: | String |
Position: | 0 |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
Especifica a ID do recurso a ser restaurado.
Tipo: | String |
Aliases: | Id |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServerName
Especifica o nome do servidor de banco de dados SQL.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceObjectiveName
Especifica o nome do objetivo de serviço.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
As marcas a serem associadas ao Banco de Dados SQL do Azure
Tipo: | Hashtable |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TargetDatabaseName
Especifica o nome do banco de dados para o qual restaurar.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserAssignedIdentityId
A lista de identidade atribuída pelo usuário para o Banco de dados SQL.
Tipo: | String[] |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VCore
Os números Vcore do Banco de Dados SQL do Azure restaurado.
Tipo: | Int32 |
Aliases: | Capacity |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ZoneRedundant
A redundância de zona a ser associada ao Banco de Dados SQL do Azure. Essa propriedade só é configurável para bancos de dados da edição Hyperscale.
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Saídas
Links Relacionados
Azure PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de