Restore-AzureRmSqlDatabase

Referência

Módulo:: AzureRM.Sql

Restaura um banco de dados SQL.

Aviso

O módulo do PowerShell do AzureRM foi oficialmente preterido em 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o 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

O cmdlet Restore-AzureRmSqlDatabase 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.

Exemplos

Exemplo 1: Restaurar um banco de dados de um point-in-time

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"

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

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"

Exemplo 3: Restaurar um banco de dados excluído

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

O primeiro comando obtém o backup de banco de dados excluído que você deseja restaurar usando Get-AzureRmSqlDeletedDatabaseBackup. O segundo comando inicia a restauração do backup de banco de dados excluído usando o cmdlet Restore-AzureRmSqlDatabase . 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

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

O primeiro comando obtém o backup de banco de dados excluído que você deseja restaurar usando Get-AzureRmSqlDeletedDatabaseBackup. O segundo comando inicia a restauração do backup de banco de dados excluído usando Restore-AzureRmSqlDatabase. 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

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"

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	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

Type:	String
Aliases:	Family
Position:	Named
Default value:	None
Required:	True
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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	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.

Type:	DateTime
Position:	Named
Default value:	None
Required:	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

Type:	String
Position:	Named
Default value:	None
Required:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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-AzureRMSqlDeletedDatabaseBackup para obter o backup de um banco de dados SQL excluído.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	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-AzureRMSqlDatabaseGeoBackup para obter um backup com redundância geográfica.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	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.

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

-LicenseType

O tipo de licença para o banco de dados SQL do Azure.

Type:	String
Position:	Named
Default value:	None
Required:	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 .

Type:	DateTime
Position:	Named
Default value:	None
Required:	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.

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

-ResourceId

Especifica a ID do recurso a ser restaurado.

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

-ServerName

Especifica o nome do servidor de banco de dados SQL.

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

-ServiceObjectiveName

Especifica o nome do objetivo de serviço.

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

-TargetDatabaseName

Especifica o nome do banco de dados para o qual restaurar.

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

-VCore

Os números Vcore do Banco de Dados SQL do Azure restaurado.

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

Entradas

DateTime

String

Saídas

AzureSqlDatabaseModel

Compartilhar via

Restore-AzureRmSqlDatabase

Syntax

Description

Exemplos

Exemplo 1: Restaurar um banco de dados de um point-in-time

Exemplo 2: Restaurar um banco de dados de um point-in-time para um pool elástico

Exemplo 3: Restaurar um banco de dados excluído

Exemplo 4: Restaurar um banco de dados excluído em um pool elástico

Exemplo 5: Restauração geográfica de um banco de dados

Parâmetros

-AsJob

-ComputeGeneration

-DefaultProfile

-DeletionDate

-Edition

-ElasticPoolName

-FromDeletedDatabaseBackup

-FromGeoBackup

-FromLongTermRetentionBackup

-FromPointInTimeBackup

-LicenseType

-PointInTime

-ResourceGroupName

-ResourceId

-ServerName

-ServiceObjectiveName

-TargetDatabaseName

-VCore

Entradas

Saídas

Recursos adicionais

Compartilhar via

Restore-AzureRmSqlDatabase

Syntax

Description

Exemplos

Exemplo 1: Restaurar um banco de dados de um point-in-time

Exemplo 2: Restaurar um banco de dados de um point-in-time para um pool elástico

Exemplo 3: Restaurar um banco de dados excluído

Exemplo 4: Restaurar um banco de dados excluído em um pool elástico

Exemplo 5: Restauração geográfica de um banco de dados

Parâmetros

-AsJob

-ComputeGeneration

-DefaultProfile

-DeletionDate

-Edition

-ElasticPoolName

-FromDeletedDatabaseBackup

-FromGeoBackup

-FromLongTermRetentionBackup

-FromPointInTimeBackup

-LicenseType

-PointInTime

-ResourceGroupName

-ResourceId

-ServerName

-ServiceObjectiveName

-TargetDatabaseName

-VCore

Entradas

Saídas

Links Relacionados

Recursos adicionais