Test-SqlAvailabilityGroup
Évalue l’intégrité d’un groupe de disponibilité.
Syntaxe
ByPath (Par défaut)
Test-SqlAvailabilityGroup
[[-Path] <String[]>]
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Test-SqlAvailabilityGroup
[-InputObject] <AvailabilityGroup[]>
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Test-SqlAvailabilityGroup évalue l’intégrité d’un groupe de disponibilité. Cette applet de commande évalue les stratégies de gestion basées sur des stratégies SQL Server. Pour exécuter cette applet de commande, vous devez disposer des droits utilisateur CONNECT, VIEW SERVER STATE et VIEW ANY DEFINITION.
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 qui s’est 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égies des groupes de disponibilité AlwaysOn.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | AvailabilityGroup[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ByObject
| Position: | 2 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-NoRefresh
Indique que l’actualisation des objets spécifiés par le paramètre Path ou InputObject n’est pas actualisé.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ByPath
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.