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.