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