Test-SqlAvailabilityGroup

  • リファレンス
モジュール:
SQLPS

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

構文

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

説明

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

例 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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:AvailabilityGroup[]
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoRefresh

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String[]
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowPolicyDetails

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

Microsoft.SqlServer.Management.Smo.AvailabilityGroup