Test-SqlAvailabilityGroup

  • Referência
Módulo:
SQLServer

Avalia a integridade de um grupo de disponibilidade.

Syntax

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 CONNECTVIEW SERVER STATE, e VIEW ANY DEFINITION direitos de usuário.

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

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

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 de Always On Grupos de Disponibilidade.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:AvailabilityGroup[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoRefresh

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.SqlServer.Management.Smo.AvailabilityGroup[]