Compartilhar via


Get-AzureSqlDatabaseCopy

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

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

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 PowerShell do Azure 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 de cópia de um banco de dados

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

Esse comando obtém o status do banco de dados chamado Pedidos 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"

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

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

-DatabaseCopy

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

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

Tipo:String
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 secundário. Se esse banco de dados 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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
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

-ServerName

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

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

Entradas

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

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.