Get-AzureSqlDatabaseCopy

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

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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é que ele retorne 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.

Type:Database
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:DatabaseCopy
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.