共用方式為

Test-SqlAvailabilityGroup

  • 參考
模組:
SQLPS

評估可用性群組的健康情況。

語法

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

Description

Test-SqlAvailabilityGroup Cmdlet 會評估可用性群組的健康情況。 此 Cmdlet 會評估 SQL Server 原則式管理原則。 若要執行此 Cmdlet，您必須具有 CONNECT、VIEW SERVER STATE 和 VIEW ANY DEFINITION 用戶權力。

範例

範例 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 會測試 AlwaysOn 可用性群組原則類別中找到的用戶原則。

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

-Confirm

在執行 Cmdlet 前提示您確認。

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

-InputObject

將可用性群組的陣列指定為 AvailabilityGroup 物件。 此 Cmdlet 會評估此參數所指定之可用性群組的健康情況。

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

-NoRefresh

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

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

-Path

指定這個 Cmdlet 評估的可用性群組路徑。 如果您未指定此參數，此 Cmdlet 會使用目前的工作位置。

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