Start-AzureSqlDatabaseCopy

  • Referência
Módulo:
Azure

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

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-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. Este 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 Padrão 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

Este 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"

Este 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

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

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 de parceiros devem estar no mesmo servidor.

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

-Database

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

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

-DatabaseName

Especifica o nome do banco de dados de origem.

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

-Force

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 Standard edition, esse parâmetro será necessário. Se esse parâmetro for especificado, ContinuousCopy também deverá ser especificado.

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

-ServerName

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

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Entradas

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

Saídas

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

Notas

  • Autenticação: este 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 New-AzureSqlDatabaseServerContext cmdlet.
  • 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 .