Test-SqlAvailabilityReplica
Avalia a integridade das réplicas de disponibilidade.
Sintaxe
ByPath (Padrão)
Test-SqlAvailabilityReplica
[[-Path] <String[]>]
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Test-SqlAvailabilityReplica
[-InputObject] <AvailabilityReplica[]>
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Test-SqlAvailabilityReplica avalia a integridade das réplicas de disponibilidade avaliando as políticas de PBM (gerenciamento baseado em política) 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 uma réplica de disponibilidade
PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica"
Este comando avalia a integridade da réplica de disponibilidade chamada MainReplica no grupo de disponibilidade MainAg e gera um breve resumo.
Exemplo 2: Avaliar a integridade de todas as réplicas de disponibilidade em um grupo de disponibilidade
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica
Este comando avalia a integridade de todas as réplicas de disponibilidade no grupo de disponibilidade chamado MainAg e gera um breve resumo para cada réplica.
Exemplo 3: Avaliar a integridade de uma réplica de disponibilidade para cada política PBM
PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -ShowPolicyDetails
Este comando avalia a integridade da réplica de disponibilidade chamada MainReplica no grupo de disponibilidade MainAg e gera os resultados de avaliação para cada política de PBM executada.
Exemplo 4: Avaliar a integridade de uma réplica de disponibilidade e incluir políticas definidas pelo usuário
PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -AllowUserPolicies
Este comando avalia a integridade da réplica de disponibilidade chamada MainReplica no grupo de disponibilidade MainAg. As políticas definidas pelo usuário são incluídas nesta avaliação.
Exemplo 5: mostrar todas as réplicas de disponibilidade que estão em um estado de erro
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica | Where-Object { $_.HealthState -eq "Error" }
Este comando mostra todas as réplicas 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 réplicas de disponibilidade a ser avaliada.
Propriedades do parâmetro
| Tipo: | AvailabilityReplica[] |
| 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 uma ou mais réplicas de disponibilidade. Esse parâmetro é opcional. Se não for especificado, o 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 o resultado de cada avaliação de política executada por esse cmdlet é mostrado. O cmdlet gera um objeto por avaliação de política. Este objeto contém campos que descrevem os resultados da avaliação.
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.