Test-SqlAvailabilityReplica
評估可用性複本的健康情況。
Syntax
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。
Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.
範例
範例 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 健康狀態 Error 為 的所有可用性複本。
參數
-AllowUserPolicies
指出此 Cmdlet 會執行Always On原則類別中找到的使用者原則。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
在執行 Cmdlet 前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定要評估的可用性複本陣列。
| Type: | AvailabilityReplica[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoRefresh
表示這個 Cmdlet 不會手動重新整理 Path 或 InputObject 參數所指定的物件。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
指定一或多個可用性複本的路徑。 這是選擇性參數。 如果未指定，則會使用目前的工作位置。
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ShowPolicyDetails
指出會顯示此 Cmdlet 所執行之每個原則評估的結果。 Cmdlet 會為每個原則評估輸出一個物件。 此物件包含描述評估結果的欄位。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
Microsoft.SqlServer.Management.Smo.AvailabilityReplica[]