Test-SqlAvailabilityReplica

  • 參考
模組:
SQLPS

評估可用性復本的健康情況。

語法

Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityReplica[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Test-SqlAvailabilityReplica Cmdlet 會藉由評估 SQL Server 原則式管理 (PBM) 原則，來評估可用性複本的健康情況。 您必須擁有 CONNECT、VIEW SERVER STATE 和 VIEW ANY DEFINITION 權限，才能執行這個 Cmdlet。

範例

範例 1：評估可用性復本的健康情況

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica"

此命令會評估MainAg可用性群組中名為MainReplica的可用性復本健康情況，並輸出簡短摘要。

範例 2：評估可用性群組中所有可用性複本的健康情況

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

此命令會評估名為 MainAg 的可用性群組中所有可用性複本的健康情況，並輸出每個復本的簡短摘要。

範例 3：評估每個 PBM 原則可用性複本的健康情況

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -ShowPolicyDetails

此命令會評估MainAg可用性群組中名為MainReplica的可用性復本健康情況，並輸出已執行之每個 PBM 原則的評估結果。

範例 4：評估可用性復本的健康情況，並包含使用者定義的原則

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -AllowUserPolicies

此命令會評估MainAg可用性群組中名為MainReplica的可用性復本健康情況。 這項評估會包含使用者定義的原則。

範例 5：顯示處於錯誤狀態的所有可用性複本

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica | 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

指定要評估的可用性復本陣列。

類型:AvailabilityReplica[]
Position:2
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-NoRefresh

表示此 Cmdlet 不會手動重新整理 Path 或 InputObject 參數所指定的物件。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Path

指定一或多個可用性復本的路徑。 這是選擇性參數。 如果未指定，則會使用目前的工作位置。

類型: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.AvailabilityReplica