Partager via

Test-SqlDatabaseReplicaState

  • Référence
Module:
SQLServer

Évalue l’intégrité d’une base de données de disponibilité.

Syntaxe

Test-SqlDatabaseReplicaState
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlDatabaseReplicaState
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <DatabaseReplicaState[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Test-SqlDatabaseReplicaState évalue l’intégrité d’une base de données de disponibilité sur tous les réplicas de disponibilité joints en évaluant SQL Server stratégies de gestion basée sur des stratégies (PBM). Vous devez disposer CONNECT, VIEW SERVER STATEet VIEW ANY DEFINITION des autorisations 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’une base de données de disponibilité

PS C:\> $Path = "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates\MainReplica.MainDatabase"
PS C:\> Test-SqlDatabaseReplicaState -Path $Path

Cette commande évalue l’intégrité de la base de données de disponibilité nommée MainDatabase sur le réplica MainReplica de disponibilité dans le groupe MainAg de disponibilité et génère un bref résumé.

Exemple 2 : Évaluer l’intégrité de toutes les bases de données de disponibilité dans un groupe de disponibilité

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

Cette commande évalue l’intégrité de toutes les bases de données de disponibilité dans le MainAg groupe de disponibilité et génère un bref résumé pour chaque base de données.

Exemple 3 : Évaluer l’intégrité de toutes les bases de données de disponibilité dans un groupe de disponibilité montrant les résultats d’évaluation PBM

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -ShowPolicyDetails

Cette commande évalue l’intégrité de toutes les bases de données de disponibilité dans le MainAg groupe de disponibilité et génère les résultats de l’évaluation pour chaque stratégie PBM exécutée.

Exemple 4 : Évaluer l’intégrité de toutes les bases de données de disponibilité dans un groupe de disponibilité et inclure des stratégies définies par l’utilisateur

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -AllowUserPolicies

Cette commande évalue l’intégrité de toutes les bases de données de disponibilité dans le MainAg groupe de disponibilité. Des stratégies définies par l'utilisateur sont comprises dans cette évaluation.

Exemple 5 : Afficher toutes les bases de données de disponibilité dans un état d’intégrité d’erreur

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

Cette commande affiche toutes les bases de données 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égies 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 d’objets d’état de base de données de disponibilité. Cette applet de commande calcule l’intégrité de ces bases de données de disponibilité.

Type:DatabaseReplicaState[]
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 états de cluster réplica de base de données de la base de données de disponibilité. Il s'agit d'un paramètre facultatif. Si elle n’est pas spécifiée, la valeur de l’emplacement de travail actuel est utilisée.

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 effectuée. L’applet de commande génère un objet par évaluation de stratégie et les résultats de l’évaluation sont disponibles dans les champs de l’objet.

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