sp_syspolicy_purge_health_state (Transact-SQL)

適用対象: SQL サーバー

ポリシー ベースの管理のポリシー正常性状態を削除します。 ポリシーの正常性状態は、オブジェクト エクスプローラー内の視覚的なインジケーター (赤い "X" を持つスクロール シンボル) です。これは、ポリシーの評価に失敗したノードを判断するのに役立ちます。

Transact-SQL 構文表記規則

構文

sp_syspolicy_purge_health_state
    [ @target_tree_root_with_id = ] 'target_tree_root_with_id'
[ ; ]

引数

[ @target_tree_root_with_id = ] 'target_tree_root_with_id'

正常性状態をクリアするオブジェクト エクスプローラー内のノードを表します。 @target_tree_root_with_id は nvarchar(400) で、既定値は NULL です。

msdb.dbo.syspolicy_system_health_state システム ビューのtarget_query_expression_with_id列から値を指定できます。

リターン コードの値

0 (成功) または 1 (失敗)。

解説

msdb システム データベースのコンテキストでsp_syspolicy_purge_health_stateを実行する必要があります。

パラメーターを指定せずにこのストアド プロシージャを実行すると、オブジェクト エクスプローラー内のすべてのノードのシステム正常性状態が削除されます。

アクセス許可

PolicyAdministratorRole 固定データベース ロールのメンバーシップが必要です。

重要

資格情報の昇格の可能性: PolicyAdministratorRole ロールのユーザーは、サーバー トリガーを作成し、データベース エンジンのインスタンスの操作に影響を与える可能性があるポリシーの実行をスケジュールできます。 たとえば、PolicyAdministratorRole ロールのユーザーは、ほとんどのオブジェクトがデータベース エンジンで作成されないようにできるポリシーを作成できます。 この資格情報が昇格される可能性があるため、PolicyAdministratorRole ロールは、データベース エンジンの構成の制御に信頼されているユーザーにのみ付与する必要があります。

例

次の例では、オブジェクト エクスプローラーの特定のノードの正常性状態を削除します。

EXEC msdb.dbo.sp_syspolicy_purge_health_state
    @target_tree_root_with_id = 'Server/Database[@ID=7]';
GO

関連するコンテンツ

• ポリシー ベースの管理ストアド プロシージャ (Transact-SQL)