Test-SqlAvailabilityGroup
评估可用性组的运行状况。
语法
ByPath （默认值）
Test-SqlAvailabilityGroup
[[-Path] <String[]>]
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Test-SqlAvailabilityGroup
[-InputObject] <AvailabilityGroup[]>
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Test-SqlAvailabilityGroup cmdlet 评估可用性组的运行状况。 此 cmdlet 评估基于 SQL Server 策略的管理策略。 若要运行此 cmdlet，必须具有 CONNECT、VIEW SERVER STATE 和 VIEW ANY DEFINITION 用户权限。
示例
示例 1：评估可用性组的运行状况
PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG"
此命令评估名为 MainAG 的可用性组的运行状况。 该命令返回摘要。
示例 2：评估所有可用性组的运行状况
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup
此命令获取 SQLSERVER：提供程序中指定位置具有可用性副本的所有可用性组。 该命令使用管道运算符将它们传递到当前 cmdlet。 该 cmdlet 评估每个可用性组的运行状况。
示例 3：显示可用性组的每个策略的结果
PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -ShowPolicyDetails
此命令评估名为 MainAG 的可用性组的运行状况。 此命令指定 ShowPolicyDetails 参数。 因此，它显示运行的每个基于策略的管理策略的评估结果。
示例 4：显示可用性组的用户定义策略的结果
PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -AllowUserPolicies
此命令评估名为 MainAG 的可用性组的运行状况。 此命令在此评估中包含用户定义的策略。
示例 5：获取具有错误状态的组
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup | Where-Object { $_.HealthState -eq "Error" }
此命令获取 SQLSERVER：提供程序中指定位置具有可用性副本的所有可用性组。 该命令使用管道运算符将它们传递到当前 cmdlet。 该 cmdlet 评估每个可用性组的运行状况。 此命令将这些结果传递给 Where-Object cmdlet，该 cmdlet 基于 HealthState 属性返回结果。
参数
-AllowUserPolicies
指示此 cmdlet 测试 AlwaysOn 可用性组的策略类别中找到的用户策略。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-InputObject
将可用性组数组指定为 AvailabilityGroup 对象。 此 cmdlet 评估此参数指定的可用性组的运行状况。
参数属性
| 类型: | AvailabilityGroup[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ByObject
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-NoRefresh
指示不会刷新 Path 或 InputObject 参数指定的对象。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Path
指定此 cmdlet 计算的可用性组的路径。 如果未指定此参数，此 cmdlet 将使用当前工作位置。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ByPath
| Position: | 2 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ShowPolicyDetails
指示此 cmdlet 显示它执行的每个策略评估的结果。 该 cmdlet 为每个策略评估返回一个对象。 每个策略对象都包含评估结果。 此信息包括是否传递的策略、策略名称和策略类别。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。