Test-SqlAvailabilityGroup

评估可用性组的运行状况。

语法

Test-SqlAvailabilityGroup
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlAvailabilityGroup
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityGroup[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Test-SqlAvailabilityGroup cmdlet 评估可用性组的运行状况。 此 cmdlet 评估基于策略的管理策略SQL Server。 若要运行此 cmdlet,必须具有CONNECTVIEW SERVER STATEVIEW ANY DEFINITION用户权限。

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

示例

示例 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 测试Always On可用性组的策略类别中找到的用户策略。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-InputObject

将可用性组数组指定为 AvailabilityGroup 对象。 此 cmdlet 评估此参数指定的可用性组的运行状况。

类型:AvailabilityGroup[]
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-NoRefresh

指示不会刷新 PathInputObject 参数指定的对象。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Path

指定此 cmdlet 计算的可用性组的路径。 如果未指定此参数,此 cmdlet 将使用当前工作位置。

类型:String[]
Position:1
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ShowPolicyDetails

指示此 cmdlet 显示它执行的每个策略评估的结果。 该 cmdlet 为每个策略评估返回一个对象。 每个策略对象都包含评估结果。 此信息包括是否传递策略、策略名称和策略类别。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.SqlServer.Management.Smo.AvailabilityGroup[]