Compartilhar via

Test-SqlAvailabilityGroup

  • Referência
Módulo:
SQLPS

Avalia a integridade de um grupo de disponibilidade.

Sintaxe

Test-SqlAvailabilityGroup
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlAvailabilityGroup
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityGroup[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Test-SqlAvailabilityGroup avalia a integridade de um grupo de disponibilidade. Esse cmdlet avalia SQL Server políticas de gerenciamento baseadas em políticas. Para executar esse cmdlet, você deve ter os 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"

Esse 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

Esse comando avalia a integridade do grupo de disponibilidade chamado MainAG. Esse comando especifica o parâmetro ShowPolicyDetails . Portanto, ele exibe os resultados de avaliação para 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

Esse 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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:AvailabilityGroup[]
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NoRefresh

Indica que não atualizará os objetos especificados pelo parâmetro Path ou InputObject .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String[]
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 foi aprovada ou não, o nome da política e a categoria de política.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.SqlServer.Management.Smo.AvailabilityGroup