Test-SqlAvailabilityGroup
Avalia a integridade de um grupo de disponibilidade.
Sintaxe
ByPath (Padrão)
Test-SqlAvailabilityGroup
[[-Path] <String[]>]
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Test-SqlAvailabilityGroup
[-InputObject] <AvailabilityGroup[]>
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Test-SqlAvailabilityGroup avalia a integridade de um grupo de disponibilidade. Esse cmdlet avalia as políticas de gerenciamento baseadas em políticas do SQL Server. Para executar esse cmdlet, você deve ter direitos de usuário CONNECT, VIEW SERVER STATE e VIEW ANY DEFINITION.
Exemplos
Exemplo 1: Avaliar a integridade de um grupo de disponibilidade
PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG"
Este comando avalia a integridade do grupo de disponibilidade chamado MainAG. O comando retorna um resumo.
Exemplo 2: Avaliar a integridade de todo o grupo de disponibilidade
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup
Esse comando obtém todos os grupos de disponibilidade que têm réplicas de disponibilidade no local especificado no provedor SQLSERVER: . O comando os passa para o cmdlet atual usando o operador de pipeline. Esse cmdlet avalia a integridade de cada grupo de disponibilidade.
Exemplo 3: Exibir resultados para cada política de um grupo de disponibilidade
PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -ShowPolicyDetails
Este comando avalia a integridade do grupo de disponibilidade chamado MainAG. Este comando especifica o parâmetro ShowPolicyDetails . Portanto, ele exibe os resultados da avaliação de cada política de gerenciamento baseada em política que foi executada.
Exemplo 4: Exibir resultados para políticas definidas pelo usuário de um grupo de disponibilidade
PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -AllowUserPolicies
Este comando avalia a integridade do grupo de disponibilidade chamado MainAG. O comando inclui políticas definidas pelo usuário nesta avaliação.
Exemplo 5: Obter grupos que têm um estado de erro
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup | Where-Object { $_.HealthState -eq "Error" }
Esse comando obtém todos os grupos de disponibilidade que têm réplicas de disponibilidade no local especificado no provedor SQLSERVER: . O comando os passa para o cmdlet atual usando o operador de pipeline. Esse cmdlet avalia a integridade de cada grupo de disponibilidade. O comando passa esses resultados para o cmdlet Where-Object, que retorna resultados com base na propriedade HealthState .
Parâmetros
-AllowUserPolicies
Indica que esse cmdlet testa as políticas de usuário encontradas nas categorias de política dos Grupos de Disponibilidade 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 grupo de disponibilidade, como objetos AvailabilityGroup . Esse cmdlet avalia a integridade dos grupos de disponibilidade especificados por esse parâmetro.
Propriedades do parâmetro
| Tipo: | AvailabilityGroup[] |
| 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 não atualizará os objetos especificados pelo parâmetro 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 do grupo de disponibilidade que esse cmdlet avalia. Se você não especificar esse parâmetro, esse cmdlet usará o local de trabalho atual.
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 exibe o resultado de cada avaliação de política que ele executa. O cmdlet retorna um objeto por avaliação de política. Cada objeto de política inclui os resultados da avaliação. Essas informações incluem se a política passou ou não, o nome da política e a categoria de política.
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.