Partilhar via


Get-AzureSqlDatabaseCopy

Verifica o status das relações de cópia.

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

Get-AzureSqlDatabaseCopy
   -ServerName <String>
   [-DatabaseName <String>]
   [-PartnerServer <String>]
   [-PartnerDatabase <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSqlDatabaseCopy
   -ServerName <String>
   -DatabaseCopy <DatabaseCopy>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSqlDatabaseCopy
   -ServerName <String>
   -Database <Database>
   [-PartnerServer <String>]
   [-PartnerDatabase <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

O cmdlet Get-AzureSqlDatabaseCopy verifica o status de uma ou mais relações de cópia ativas. Execute este cmdlet depois de executar o cmdlet Start-AzureSqlDatabaseCopy ou Stop-AzureSqlDatabaseCopy. Você pode verificar uma relação de cópia específica, todas as relações de cópia ou uma lista filtrada de relações de cópia, como todas as cópias em um servidor de destino específico. Você pode executar esse cmdlet no servidor que hospeda o banco de dados de origem ou de destino.

Este cmdlet é síncrono. O cmdlet bloqueia o console do Azure PowerShell até retornar um objeto de status.

Os parâmetros PartnerServer e PartnerDatabase são opcionais. Se você não especificar nenhum dos parâmetros, esse cmdlet retornará uma tabela de resultados. Para ver o status de apenas um banco de dados específico, especifique ambos os parâmetros.

Exemplos

Exemplo 1: Obter o status da cópia de um banco de dados

PS C:\> Get-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf658"

Este comando obtém o status do banco de dados chamado Orders no servidor chamado lpqd0zbr8y. O parâmetro PartnerServer restringe esse comando ao servidor bk0b8kf658.

Exemplo 2: Obter o status de todas as cópias em um servidorObter o status de todas as cópias em um servidor

PS C:\> Get-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y"

Este comando obtém o status de todas as cópias ativas no servidor chamado lpqd0zbr8y.

Parâmetros

-Database

Especifica um objeto que representa o Banco de Dados SQL do Azure de origem. Este cmdlet obtém o status de cópia do banco de dados especificado por esse parâmetro.

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

-DatabaseCopy

Especifica um objeto que representa um banco de dados. Este cmdlet obtém o status de cópia do banco de dados especificado por esse parâmetro. Este parâmetro aceita a entrada do pipeline.

Tipo:DatabaseCopy
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. Este cmdlet obtém o status de cópia do banco de dados especificado por esse parâmetro.

Tipo:String
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 secundário. Se esse banco de dados não for encontrado na exibição de gerenciamento dinâmico sys.dm_database_copies, esse cmdlet retornará um objeto de status vazio.

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

-PartnerServer

Especifica o nome do servidor que hospeda o banco de dados de destino. Se esse servidor não for encontrado no modo de exibição de gerenciamento dinâmico sys.dm_database_copies, esse cmdlet retornará um objeto de status vazio.

Tipo:String
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

-ServerName

Especifica o nome do servidor no qual a cópia do banco de dados reside.

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

Entradas

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

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 o cmdlet New-AzureSqlDatabaseServerContext.