Partilhar via

Start-AzureSqlDatabaseRestore

  • Referência
Módulo:
Azure

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

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo 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ásicos 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.

Atualmente, 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 ponto no tempo

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, armazena-o na variável $Database.

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

Exemplo 2: Restaurar um banco de dados especificado pelo nome para um ponto no tempo

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

Este comando restaura o banco de dados chamado Database17 para um ponto específico no tempo. O comando especifica o nome do novo banco de dados.

Exemplo 3: Restaurar um banco de dados descartado especificado como um objeto para um ponto no tempo

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 no 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 o nome do 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.

Tipo:DateTime
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Profile

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

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RestorableDropped

Indica que esse cmdlet restaura um banco de dados descartado restaurável.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SourceDatabase

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

Tipo:Database
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SourceDatabaseName

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SourceRestorableDroppedDatabase

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

Tipo:RestorableDroppedDatabase
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TargetDatabaseName

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TargetServerName

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

Atualmente, 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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

Notas

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