sp_syspolicy_purge_health_state (Transact-SQL)

適用対象:SQL Server

ポリシー ベースの管理のポリシー正常性状態を削除します。 ポリシーの正常性状態は、オブジェクト エクスプローラー内の視覚的なインジケーター (赤い "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.

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

リターン コードの値

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

解説

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

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

アクセス許可

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

重要

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

例

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

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

関連するコンテンツ

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