Start-AzureSqlDatabaseRestore

  • Referência
Módulo:
Azure

Executa uma restauração point-in-time de um banco de dados.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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

O cmdlet Start-AzureSqlDatabaseRestore executa uma restauração point-in-time de um banco de dados Basic, Standard ou Premium. O Banco de Dados SQL do Azure retém backups de banco de dados Básico por 7 dias, Standard por 14 dias e Premium por 35 dias. A operação de restauração cria um novo banco de dados. Se o banco de dados de origem não for excluído, os parâmetros SourceDatabaseName e TargetDatabaseName deverão ter valores diferentes.

No momento, o Banco de Dados SQL do Azure não oferece suporte à restauração entre servidores. Os nomes dos servidores de origem e de destino devem ser os mesmos.

Exemplos

Exemplo 1: Restaurar um banco de dados especificado como um objeto para um point-in-time

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"

O primeiro comando obtém um objeto de banco de dados para o banco de dados chamado Database17 no servidor chamado Server01 e, em seguida, o armazena na variável $Database.

O segundo comando restaura o banco de dados para um point-in-time específico. O comando especifica em nome para o novo banco de dados.

Exemplo 2: Restaurar um banco de dados especificado por nome para um point-in-time

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

Esse comando restaura o banco de dados chamado Database17 para um point-in-time específico. O comando especifica em nome para o novo banco de dados.

Exemplo 3: Restaurar um banco de dados descartado especificado como um objeto para um point-in-time

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"

O primeiro comando obtém um objeto de banco de dados para o banco de dados chamado Database01 no servidor chamado Server01. O comando especifica o parâmetro RestorableDroped . Portanto, o cmdlet obtém o banco de dados descartado restaurável do ponto de restauração especificado. O comando armazena esse objeto de banco de dados na variável $Database.

O segundo comando restaura o banco de dados descartado especificado por $Database. O comando especifica em nome para o novo banco de dados.

Parâmetros

-PointInTime

Especifica o ponto de restauração para o qual restaurar o banco de dados. Quando a operação de restauração é concluída, o banco de dados é restaurado para o estado em que estava na data e hora especificadas por esse parâmetro. Por padrão, para um banco de dados ativo definido como a hora atual e para um banco de dados descartado, esse cmdlet usa a hora em que o banco de dados foi descartado.

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

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

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

-RestorableDropped

Indica que esse cmdlet restaura um banco de dados restaurado descartado.

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

-SourceDatabase

Especifica o nome do banco de dados que esse cmdlet restaura.

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

-SourceDatabaseDeletionDate

Especifica a data e a hora em que o banco de dados foi excluído. Você deve incluir milissegundos ao especificar o tempo para corresponder ao tempo real de exclusão do banco de dados.

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

-SourceDatabaseName

Especifica o nome do banco de dados dinâmico que esse cmdlet restaura.

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

-SourceRestorableDroppedDatabase

Especifica um objeto que representa o banco de dados restaurado descartado que esse cmdlet restaura. Para obter um objeto RestorableDroppedDatabase , use o cmdlet Get-AzureSqlDatabase e especifique o parâmetro RestorableDroped .

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

-SourceServerName

Especifica o nome do servidor no qual o banco de dados de origem está ativo e em execução, ou no qual o banco de dados de origem foi executado antes de ser excluído.

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

-TargetDatabaseName

Especifica o nome do novo banco de dados que a operação de restauração cria.

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

-TargetServerName

Especifica o nome do servidor para o qual esse cmdlet restaura o banco de dados.

No momento, o Banco de Dados SQL do Azure não oferece suporte à restauração entre servidores. Os nomes dos servidores de origem e de destino devem ser os mesmos.

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

Entradas

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

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

Saídas

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

Observações

  • Você deve usar a autenticação baseada em certificado para executar esse cmdlet. Execute os seguintes comandos no computador em que executar 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"