Remove-SqlAvailabilityDatabase
Remove um banco de dados de disponibilidade de seu grupo de disponibilidade.
Sintaxe
ByPath (Padrão)
Remove-SqlAvailabilityDatabase
[-Path] <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Remove-SqlAvailabilityDatabase
[-InputObject] <AvailabilityDatabase[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Remove-SqlAvailabilityDatabase remove o banco de dados de disponibilidade de seu grupo de disponibilidade. O parâmetro InputObject ou Path especifica o banco de dados de disponibilidade.
Se você executar esse cmdlet na instância do servidor que hospeda a réplica primária, o cmdlet removerá o banco de dados primário e todos os bancos de dados secundários correspondentes do grupo de disponibilidade.
Se você executar esse cmdlet em uma instância de servidor que hospeda uma réplica secundária, o cmdlet removerá apenas o banco de dados secundário local do grupo de disponibilidade. O banco de dados secundário não está mais ingressado no grupo de disponibilidade, mas outras cópias do banco de dados continuam ingressadas.
Exemplos
Exemplo 1: remover um banco de dados de um grupo de disponibilidade
PS C:\> Remove-SqlAvailabilityDatabase -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases\Database16"
Esse comando remove o banco de dados de disponibilidade chamado Database16 do grupo de disponibilidade chamado MainAG. Esse comando é executado na instância do servidor que hospeda a réplica primária. Portanto, ele remove o banco de dados primário e todos os seus bancos de dados secundários correspondentes do grupo de disponibilidade. A sincronização de dados não ocorre mais para esse banco de dados em nenhuma réplica secundária.
Exemplo 2: remover todos os bancos de dados de um grupo de disponibilidade
PS C:\> Get-ChildItem "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases" | Remove-SqlAvailabilityDatabase
Esse comando obtém todos os bancos de dados de disponibilidade que pertencem ao MainAG e os passa para o cmdlet atual usando o operador de pipeline. O cmdlet atual remove cada banco de dados de disponibilidade.
Exemplo 3: remover um banco de dados secundário de um grupo de disponibilidade
PS C:\> Remove-SqlAvailabilityDatabase -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases\Database16"
Esse comando remove o banco de dados secundário chamado Database16 da réplica secundária hospedada pela instância do servidor chamada SecondaryServer\Instance. A sincronização de dados com os bancos de dados secundários removidos é interrompida. Este comando não afeta o banco de dados primário ou nenhum outro banco de dados secundário.
Para reiniciar a sincronização de dados neste banco de dados secundário, reencontro-a ao grupo de disponibilidade executando o cmdlet Add-SqlAvailabilityDatabase na mesma instância do servidor.
Exemplo 4: Criar um script para remover um banco de dados de um grupo de disponibilidade
PS C:\> Remove-SqlAvailabilityDatabase -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases\Database16" -Script
Esse comando cria um script Transact-SQL que remove o banco de dados de disponibilidade chamado Database16 do grupo de disponibilidade chamado MainAG. O comando não executa essa ação.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-InputObject
Especifica o banco de dados de disponibilidade, como um objeto AvailabilityDatabase , que esse cmdlet remove.
Propriedades do parâmetro
| Tipo: | AvailabilityDatabase[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ByObject
| Cargo: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Path
Especifica o caminho de um banco de dados de disponibilidade que o cmdlet remove.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ByPath
| Cargo: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Script
Indica que esse cmdlet retorna um script Transact-SQL que executa a tarefa executada por esse cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
Microsoft.SqlServer.Management.Smo.AvailabilityDatabase
Você pode passar um banco de dados de disponibilidade para este cmdlet.