Test-SqlDatabaseReplicaState

评估可用性数据库的运行状况。

语法

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

说明

Test-SqlDatabaseReplicaState cmdlet 通过评估基于SQL Server策略的管理 (PBM) 策略评估所有联接可用性副本的可用性数据库的运行状况。 必须具有 CONNECT执行 VIEW SERVER STATE此 cmdlet 的权限和 VIEW ANY DEFINITION 权限。

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

示例

示例 1:评估可用性数据库的运行状况

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

此命令评估可用性组中MainAg可用性副本MainReplica上命名MainDatabase的可用性数据库的运行状况,并输出简短摘要。

示例 2:评估可用性组中所有可用性数据库的运行状况

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

此命令评估可用性组中所有可用性数据库的 MainAg 运行状况,并输出每个数据库的简短摘要。

示例 3:评估可用性组中所有可用性数据库的运行状况,其中显示了 PBM 评估结果

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

此命令评估可用性组中所有可用性数据库的 MainAg 运行状况,并输出执行的每个 PBM 策略的评估结果。

示例 4:评估可用性组中所有可用性数据库的运行状况并包括用户定义的策略

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

此命令评估可用性组中所有可用性数据库的 MainAg 运行状况。 在此评估中包括用户定义的策略。

示例 5:显示处于错误运行状况的所有可用性数据库

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

此命令显示具有可用性组中运行状况ErrorMainAg的所有可用性数据库。

参数

-AllowUserPolicies

指示此 cmdlet 运行在Always On策略类别中找到的用户策略。

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

-Confirm

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

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

-InputObject

指定可用性数据库状态对象的数组。 此 cmdlet 计算这些可用性数据库的运行状况。

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

-NoRefresh

指示此 cmdlet 不会手动刷新 PathInputObject 参数指定的对象。

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

-Path

指定可用性数据库的一个或多个数据库副本群集状态的路径。 这是一个可选参数。 如果未指定,则使用当前工作位置的值。

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