次の方法で共有


Test-SqlAvailabilityGroup

可用性グループの正常性を評価します。

構文

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

説明

Test-SqlAvailabilityGroup コマンドレットは、可用性グループの正常性を評価します。 このコマンドレットは、ポリシー ベースの管理ポリシー SQL Server評価します。 このコマンドレットを実行するには、ユーザー権限、およびVIEW ANY DEFINITIONユーザーVIEW SERVER STATE権限がCONNECT必要です。

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

例 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: プロバイダー内の指定された場所に可用性レプリカがあるすべての可用性グループを取得します。 コマンドは、パイプライン演算子を使用して現在のコマンドレットに渡します。 このコマンドレットは、各可用性グループの正常性を評価します。

例 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: プロバイダー内の指定された場所に可用性レプリカがあるすべての可用性グループを取得します。 コマンドは、パイプライン演算子を使用して現在のコマンドレットに渡します。 このコマンドレットは、各可用性グループの正常性を評価します。 このコマンドは、これらの結果を Where-Object コマンドレットに渡します。このコマンドレットは、 HealthState プロパティに基づいて結果を返します。

パラメーター

-AllowUserPolicies

このコマンドレットは、可用性グループのポリシー カテゴリに含まれるユーザー ポリシー Always Onテストすることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

可用性グループオブジェクトとして可用性グループの配列を指定します。 このコマンドレットは、このパラメーターが指定する可用性グループの正常性を評価します。

型:AvailabilityGroup[]
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-NoRefresh

Path または InputObject パラメーターで指定されたオブジェクトを更新しないことを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Path

このコマンドレットが評価する可用性グループのパスを指定します。 このパラメーターを指定しない場合、このコマンドレットは現在の作業場所を使用します。

型:String[]
配置:1
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ShowPolicyDetails

このコマンドレットが実行する各ポリシー評価の結果を表示することを示します。 このコマンドレットは、ポリシー評価ごとに 1 つのオブジェクトを返します。 各ポリシー オブジェクトには、評価の結果が含まれます。 この情報には、ポリシーが渡されたかどうか、ポリシー名、およびポリシー カテゴリが含まれます。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.SqlServer.Management.Smo.AvailabilityGroup[]