通过

Test-SqlDatabaseReplicaState

  • 参考
模块:
SQLPS

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

语法

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 和 VIEW ANY DEFINITION 权限才能执行此 cmdlet。

示例

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

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

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

示例 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" }

此命令显示 MainAg 可用性组中运行状况为“错误”的所有可用性数据库。

参数

-AllowUserPolicies

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

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

-Confirm

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

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

-InputObject

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

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

-NoRefresh

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

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

-Path

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

类型:String[]
Position:2
默认值: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