Compartilhar via

Start-AzureSqlDatabaseRestore

  • Referência
Módulo:
Azure

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

Observação

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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 para a hora atual e para um banco de dados descartado, esse cmdlet usa a hora em que o banco de dados foi descartado.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RestorableDropped

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SourceDatabase

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

Tipo:Database
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SourceDatabaseName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 .

Tipo:RestorableDroppedDatabase
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TargetDatabaseName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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"