Test-SqlAvailabilityReplica
Évalue l’intégrité des réplicas de disponibilité.
Syntax
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 CONNECT
des VIEW SERVER STATE
autorisations 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Spécifie un tableau de réplicas de disponibilité à évaluer.
Type: | AvailabilityReplica[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.SqlServer.Management.Smo.AvailabilityReplica[]