Partager via

Test-SqlAvailabilityReplica

  • Référence
Module:
SQLServer

Évalue l’intégrité des réplicas de disponibilité.

Syntaxe

Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityReplica[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Test-SqlAvailabilityReplica évalue l’intégrité des réplicas de disponibilité en évaluant SQL Server stratégies pbM (Policy Based Management). Vous devez disposer CONNECTdes VIEW SERVER STATEautorisations nécessaires VIEW ANY DEFINITION pour exécuter cette applet de commande.

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

Exemples

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

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica"

Cette commande évalue l’intégrité du réplica de disponibilité nommé MainReplica dans le MainAg groupe de disponibilité et génère un bref résumé.

Exemple 2 : Évaluer l’intégrité de tous les réplicas de disponibilité dans un groupe de disponibilité

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica

Cette commande évalue l’intégrité de tous les réplicas de disponibilité dans le groupe de disponibilité nommé MainAg et génère un bref résumé pour chaque réplica.

Exemple 3 : Évaluer l’intégrité d’un réplica de disponibilité pour chaque stratégie PBM

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -ShowPolicyDetails

Cette commande évalue l’intégrité du réplica de disponibilité nommé MainReplica dans le MainAg groupe de disponibilité et génère les résultats d’évaluation pour chaque stratégie PBM exécutée.

Exemple 4 : Évaluer l’intégrité d’un réplica de disponibilité et inclure des stratégies définies par l’utilisateur

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -AllowUserPolicies

Cette commande évalue l’intégrité du réplica de disponibilité nommé MainReplica dans le MainAg groupe de disponibilité. Des stratégies définies par l'utilisateur sont comprises dans cette évaluation.

Exemple 5 : Afficher tous les réplicas de disponibilité qui sont dans un état d’erreur

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica | Where-Object { $_.HealthState -eq "Error" }

Cette commande affiche tous les réplicas de disponibilité avec un état d’intégrité dans le MainAg groupe de Error disponibilité.

Paramètres

-AllowUserPolicies

Indique que cette applet de commande exécute des stratégies utilisateur trouvées dans les catégories de stratégie Always On.

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 réplicas de disponibilité à évaluer.

Type:AvailabilityReplica[]
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 que cette applet de commande n’actualise pas manuellement les objets spécifiés par les paramètres 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 à un ou plusieurs réplicas de disponibilité. Ce paramètre est facultatif. S’il n’est pas spécifié, l’emplacement de travail actuel est utilisé.

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 le résultat de chaque évaluation de stratégie effectuée par cette applet de commande s’affiche. L’applet de commande génère un objet par évaluation de stratégie. Cet objet contient des champs qui décrivent les résultats de l’évaluation.

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.AvailabilityReplica[]