Compartilhar via

Start-AzureSqlDatabaseCopy

  • Referência
Módulo:
Azure

Inicia uma operação de cópia de um Banco de Dados SQL do Azure.

Observação

Os cmdlets referenciados 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, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

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

Sintaxe

Start-AzureSqlDatabaseCopy
     -ServerName <String>
     -Database <Database>
     [-PartnerServer <String>]
     -PartnerDatabase <String>
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureSqlDatabaseCopy
     -ServerName <String>
     -Database <Database>
     -PartnerServer <String>
     [-PartnerDatabase <String>]
     [-ContinuousCopy]
     [-OfflineSecondary]
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureSqlDatabaseCopy
     -ServerName <String>
     -DatabaseName <String>
     [-PartnerServer <String>]
     -PartnerDatabase <String>
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureSqlDatabaseCopy
     -ServerName <String>
     -DatabaseName <String>
     -PartnerServer <String>
     [-PartnerDatabase <String>]
     [-ContinuousCopy]
     [-OfflineSecondary]
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

O cmdlet Start-AzureSqlDatabaseCopy inicia uma operação de cópia única ou uma operação de cópia contínua de um Banco de Dados SQL do Azure específico. Esse cmdlet não é transacional.

O banco de dados original é o banco de dados de origem. A cópia é o banco de dados secundário ou de destino. Para uma cópia contínua, os bancos de dados de origem e de destino não podem residir no mesmo servidor, e os servidores que hospedam os bancos de dados de origem e de destino devem fazer parte da mesma assinatura.

Se você não especificar o parâmetro ContinuousCopy , esse cmdlet criará uma cópia única do banco de dados de origem. Quando a resposta é recebida, a operação ainda pode estar em andamento. Você pode monitorar a operação usando o cmdlet Get-AzureSqlDatabaseCopy ou Get-AzureSqlDatabaseOperation.

Se você especificar ContinuousCopy, esse cmdlet criará uma cópia contínua do banco de dados de origem. Quando a resposta for recebida, a operação estará em andamento. Você pode monitorar a operação usando Get-AzureSqlDatabaseCopy ou Get-AzureSqlDatabaseOperation.

Você pode criar uma cópia contínua como um banco de dados online ou offline. A cópia contínua online é usada para configurar a Replicação Geográfica Ativa para o Banco de Dados SQL do Azurehttps://azure.microsoft.com/en-us/documentation/articles/sql-database-geo-replication-overview/. A cópia contínua offline é usada para configurar a Replicação Geográfica Standard para o Banco de Dados SQL do Azurehttps://azure.microsoft.com/en-us/documentation/articles/sql-database-business-continuity-scenarios/.

Exemplos

Exemplo 1: Agendar uma cópia contínua do banco de dados

PS C:\> Start-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf65" -ContinuousCopy

Esse comando agenda uma cópia contínua do banco de dados chamado Orders no servidor chamado lpqd0zbr8y. O comando cria um banco de dados de destino no servidor chamado bk0b8kf658.

Exemplo 2: Criar uma cópia única no mesmo servidor

PS C:\> Start-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerDatabase "OrdersCopy"

Esse comando cria uma cópia única do banco de dados chamado Orders no servidor chamado lpqd0zbr8y. O comando cria uma cópia chamada OrdersCopy no mesmo servidor.

Exemplo 3: Agendar uma cópia contínua do banco de dados offline

PS C:\> Start-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf65" -ContinuousCopy -OfflineSecondary

Esse comando agenda uma cópia contínua do banco de dados chamado Orders no servidor chamado lpqd0zbr8y. Esse comando cria um banco de dados de destino offline no servidor chamado bk0b8kf658.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-ContinuousCopy

Indica que a cópia do banco de dados será uma cópia contínua (um banco de dados de réplica). A cópia contínua não é suportada no mesmo servidor. Se esse parâmetro não for especificado, uma cópia única será executada. Para uma cópia única, os bancos de dados de origem e parceiros devem estar no mesmo servidor.

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

-Database

Especifica um objeto que representa o Banco de Dados SQL do Azure de origem. Esse parâmetro aceita a entrada do pipeline.

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

-DatabaseName

Especifica o nome do banco de dados de origem.

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

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

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

-OfflineSecondary

Especifica que uma cópia contínua é uma cópia passiva em vez de uma cópia ativa. Se o banco de dados de origem for um banco de dados da edição Standard, esse parâmetro será necessário. Se esse parâmetro for especificado, ContinuousCopy também deverá ser especificado.

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

-PartnerDatabase

Especifica o nome do banco de dados de destino. Se você especificar o parâmetro ContinuousCopy , o valor de PartnerDatabase deverá corresponder ao nome do banco de dados de origem. Se você não especificar ContinuousCopy, deverá especificar um nome para o banco de dados de destino, que pode ser diferente do nome do banco de dados de origem.

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

-PartnerServer

Especifica o nome do servidor que hospeda o banco de dados de destino. Esse servidor deve estar na mesma assinatura do Azure que o servidor de banco de dados de origem.

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

-Profile

Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o 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

-ServerName

Especifica o nome do servidor no qual o banco de dados de origem reside.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

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

Saídas

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

Observações

  • Autenticação: esse cmdlet requer autenticação baseada em certificado. Para obter um exemplo de como usar a autenticação baseada em certificado para definir a assinatura atual, consulte o cmdlet New-AzureSqlDatabaseServerContext.
  • Monitoramento: para verificar o status de uma ou mais relações de cópia contínua ativas no servidor, use o cmdlet Get-AzureSqlDatabaseCopy . Para verificar o status das operações na origem e no destino da relação de cópia contínua, use o cmdlet Get-AzureSqlDatabaseOperation .