sp_syspolicy_configure (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

ポリシー ベースの管理を有効にするかどうかなど、ポリシー ベースの管理の設定を構成します。

Transact-SQL 構文表記規則

構文

sp_syspolicy_configure
    [ @name = ] N'name'
    , [ @value = ] value
[ ; ]

引数

[ @name = ] N'name'

構成する設定の名前。 @nameは sysname であり、必須であり、NULL または空の文字列にすることはできません。

@nameには、次のいずれかの値を指定できます。

  • Enabled - ポリシー ベースの管理が有効かどうかを決定します。

  • HistoryRetentionInDays - ポリシー評価履歴を保持する日数を指定します。 に 0設定すると、履歴は自動的に削除されません。

  • LogOnSuccess - ポリシー ベースの管理がポリシーの評価に成功したかどうかを示します。

[ @value = ] value

@nameの指定した値に関連付けられている値。 @valueはsql_variantであり、必須です。

  • @nameに [有効] を指定した場合は、次のいずれかの値を使用できます。

    • 0 - ポリシー ベースの管理を無効にします。
    • 1 - ポリシー ベースの管理を有効にします。

  • @nameに指定HistoryRententionInDaysする場合は、日数を整数値として指定します。

  • @nameに指定LogOnSuccessする場合は、次のいずれかの値を使用できます。

    • 0 - 失敗したポリシー評価のみをログに記録します。
    • 1 - ポリシーの評価の成功と失敗の両方をログに記録します。

リターン コードの値

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

解説

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

これらの設定の現在の値を表示するには、システム ビューに対してクエリを msdb.dbo.syspolicy_configuration 実行します。

アクセス許可

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

重要

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

例

次の例では、ポリシー ベースの管理を有効にします。

EXEC msdb.dbo.sp_syspolicy_configure
    @name = N'Enabled',
    @value = 1;
GO

次の例では、ポリシー履歴の保持期間を 14 日に設定します。

EXEC msdb.dbo.sp_syspolicy_configure
    @name = N'HistoryRetentionInDays',
    @value = 14;
GO

次の例では、成功したポリシー評価と失敗したポリシー評価の両方をログに記録するようにポリシー ベースの管理を構成します。

EXEC msdb.dbo.sp_syspolicy_configure
    @name = N'LogOnSuccess',
    @value = 1;
GO

関連するコンテンツ