Get-AzureSqlDatabaseCopy
Verifica o status das relações de cópia.
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
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 esse 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.
Esse 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 apenas de um banco de dados específico, especifique os dois 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 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"
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 a entrada do 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 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 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.