Test-SqlDatabaseReplicaState
評估可用性資料庫的健康情況。
語法
ByPath (預設值)
Test-SqlDatabaseReplicaState
[[-Path] <String[]>]
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Test-SqlDatabaseReplicaState
[-InputObject] <DatabaseReplicaState[]>
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
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 中可用性復本 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" }
此命令會顯示MainAg可用性群組中健康狀態為「錯誤」的所有可用性資料庫。
參數
-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
指定可用性資料庫狀態物件的陣列。 此 Cmdlet 會計算這些可用性資料庫的健全狀況。
參數屬性
| 類型: | DatabaseReplicaState[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByObject
| Position: | 2 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NoRefresh
表示此 Cmdlet 不會手動重新整理 Path 或 InputObject 參數所指定的物件。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Path
指定可用性資料庫的一或多個資料庫復本叢集狀態的路徑。 這是選擇性參數。 如果未指定，則會使用目前工作位置的值。
參數屬性
| 類型: | 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。