Start-AzureSqlDatabaseRestore
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"