Test-SqlDatabaseReplicaState
Avalia a integridade de um banco de dados de disponibilidade.
Sintaxe
ByPath (Padrão)
Test-SqlDatabaseReplicaState
[[-Path] <String[]>]
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Test-SqlDatabaseReplicaState
[-InputObject] <DatabaseReplicaState[]>
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Test-SqlDatabaseReplicaState avalia a integridade de um banco de dados de disponibilidade em todas as réplicas de disponibilidade unidas avaliando as políticas de PBM (gerenciamento baseado em políticas) do SQL Server. Você deve ter as permissões CONNECT, VIEW SERVER STATE e VIEW ANY DEFINITION para executar esse cmdlet.
Exemplos
Exemplo 1: Avaliar a integridade de um banco de dados de disponibilidade
PS C:\> $Path = "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates\MainReplica.MainDatabase"
PS C:\> Test-SqlDatabaseReplicaState -Path $Path
Este comando avalia a integridade do banco de dados de disponibilidade chamado MainDatabase na réplica de disponibilidade MainReplica no grupo de disponibilidade MainAg e gera um breve resumo.
Exemplo 2: Avaliar a integridade de todos os bancos de dados de disponibilidade em um grupo de disponibilidade
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState
Esse comando avalia a integridade de todos os bancos de dados de disponibilidade no grupo de disponibilidade MainAg e gera um breve resumo para cada banco de dados.
Exemplo 3: Avaliar a integridade de todos os bancos de dados de disponibilidade em um grupo de disponibilidade mostrando os resultados da avaliação do PBM
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -ShowPolicyDetails
Esse comando avalia a integridade de todos os bancos de dados de disponibilidade no grupo de disponibilidade MainAg e gera os resultados da avaliação de cada política de PBM executada.
Exemplo 4: Avaliar a integridade de todos os bancos de dados de disponibilidade em um grupo de disponibilidade e incluir políticas definidas pelo usuário
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -AllowUserPolicies
Este comando avalia a integridade de todos os bancos de dados de disponibilidade no grupo de disponibilidade MainAg. As políticas definidas pelo usuário são incluídas nesta avaliação.
Exemplo 5: Mostrar todos os bancos de dados de disponibilidade em um estado de integridade de erro
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState | Where-Object { $_.HealthState -eq "Error" }
Este comando mostra todos os bancos de dados de disponibilidade com um estado de integridade de "Erro" no grupo de disponibilidade MainAg.
Parâmetros
-AllowUserPolicies
Indica que esse cmdlet executa políticas de usuário encontradas nas categorias de política AlwaysOn.
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 |
-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 uma matriz de objetos de estado do banco de dados de disponibilidade. Esse cmdlet calcula a integridade desses bancos de dados de disponibilidade.
Propriedades do parâmetro
| Tipo: | DatabaseReplicaState[] |
| 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 |
-NoRefresh
Indica que esse cmdlet não atualizará manualmente os objetos especificados pelos parâmetros Path ou InputObject .
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 |
-Path
Especifica o caminho para um ou mais estados de cluster de réplica de banco de dados do banco de dados de disponibilidade. Esse é um parâmetro opcional. Se não for especificado, o valor do local de trabalho atual será usado.
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: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ShowPolicyDetails
Indica que esse cmdlet mostra o resultado de cada avaliação de política executada. O cmdlet gera um objeto por avaliação de política e os resultados da avaliação estão disponíveis nos campos do objeto.
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.