Partager via

Test-SqlAvailabilityGroup

  • Référence
Module:
SQLServer

Évalue l’intégrité d’un groupe de disponibilité.

Syntaxe

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

Description

L’applet de commande Test-SqlAvailabilityGroup évalue l’intégrité d’un groupe de disponibilité. Cette applet de commande évalue SQL Server stratégies de gestion basées sur des stratégies. Pour exécuter cette applet de commande, vous devez disposer CONNECTVIEW SERVER STATEdes droits d’utilisateur et VIEW ANY DEFINITION des droits d’utilisateur.

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

Exemples

Exemple 1 : Évaluer l’intégrité d’un groupe de disponibilité

PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG"

Cette commande évalue l’intégrité du groupe de disponibilité nommé MainAG. La commande retourne un résumé.

Exemple 2 : Évaluer l’intégrité de tous les groupes de disponibilité

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup

Cette commande obtient tous les groupes de disponibilité qui ont des réplicas de disponibilité à l’emplacement spécifié dans le fournisseur SQLSERVER : . La commande les transmet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. Cette applet de commande évalue l’intégrité de chaque groupe de disponibilité.

Exemple 3 : Afficher les résultats pour chaque stratégie d’un groupe de disponibilité

PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -ShowPolicyDetails

Cette commande évalue l’intégrité du groupe de disponibilité nommé MainAG. Cette commande spécifie le paramètre ShowPolicyDetails. Par conséquent, il affiche les résultats de l’évaluation pour chaque stratégie de gestion basée sur des stratégies exécutée.

Exemple 4 : Afficher les résultats pour les stratégies définies par l’utilisateur d’un groupe de disponibilité

PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -AllowUserPolicies

Cette commande évalue l’intégrité du groupe de disponibilité nommé MainAG. La commande inclut des stratégies définies par l’utilisateur dans cette évaluation.

Exemple 5 : Obtenir des groupes qui ont un état d’erreur

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup | Where-Object { $_.HealthState -eq "Error" }

Cette commande obtient tous les groupes de disponibilité qui ont des réplicas de disponibilité à l’emplacement spécifié dans le fournisseur SQLSERVER : . La commande les transmet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. Cette applet de commande évalue l’intégrité de chaque groupe de disponibilité. La commande transmet ces résultats à l’applet de commande Where-Object , qui retourne les résultats en fonction de la propriété HealthState .

Paramètres

-AllowUserPolicies

Indique que cette applet de commande teste les stratégies utilisateur trouvées dans les catégories de stratégie de Always On groupes de disponibilité.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie un tableau de groupes de disponibilité, en tant qu’objets AvailabilityGroup. Cette applet de commande évalue l’intégrité des groupes de disponibilité spécifiés par ce paramètre.

Type:AvailabilityGroup[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NoRefresh

Indique qu’il n’actualise pas les objets spécifiés par le paramètre Path ou InputObject .

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifie le chemin d’accès du groupe de disponibilité évalué par cette applet de commande. Si vous ne spécifiez pas ce paramètre, cette applet de commande utilise l’emplacement de travail actuel.

Type:String[]
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ShowPolicyDetails

Indique que cette applet de commande affiche le résultat de chaque évaluation de stratégie qu’elle effectue. L’applet de commande retourne un objet par évaluation de stratégie. Chaque objet de stratégie inclut les résultats de l’évaluation. Ces informations incluent si la stratégie a passé ou non, le nom de la stratégie et la catégorie de stratégie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.SqlServer.Management.Smo.AvailabilityGroup[]