sp_syspolicy_add_policy_category (Transact-SQL)

構文

sp_syspolicy_add_policy_category [ @name = ] 'name'
    [ , [ @mandate_database_subscriptions = ] mandate_database_subscriptions ]
        , [ @policy_category_id = ] policy_category_id OUTPUT

引数

• [ @name= ] 'name'
  ポリシー カテゴリの名前を指定します。name のデータ型は sysname で、必ず指定する必要があります。name には NULL または空の文字列を指定できません。

• [ @mandate_database_subscriptions = ] mandate_database_subscriptions
  データベース サブスクリプションがポリシー カテゴリに対して必須であるかどうかを指定します。mandate_database_subscriptions のデータ型は bit で、既定値は 1 (有効) です。

• [ @policy_category_id= ] policy_category_id
  ポリシー カテゴリの識別子を指定します。policy_category_id のデータ型は int で、OUTPUT として返されます。

リターン コードの値

成功した場合は 0 を、失敗した場合は 1 をそれぞれ返します。

説明

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

権限

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

セキュリティに関する注意
資格情報が昇格される可能性について: PolicyAdministratorRole ロールに割り当てられているユーザーは、サーバー トリガーを作成して、データベース エンジン インスタンスの動作に影響する可能性があるポリシーの実行をスケジュールできます。たとえば、PolicyAdministratorRole ロールに割り当てられているユーザーは、ほとんどのオブジェクトがデータベース エンジンで作成されないようにすることができるポリシーを作成できます。このように、資格情報が昇格される可能性があるので、PolicyAdministratorRole ロールは、データベース エンジンの構成の制御について信頼できるユーザーにのみ許可してください。

例

次の例では、カテゴリのサブスクリプションが必須ではないポリシー カテゴリを作成します。つまり、カテゴリでポリシーを有効または無効にして個々のデータベースを構成できます。

DECLARE @policy_category_id int;

EXEC msdb.dbo.sp_syspolicy_add_policy_category
  @name = N'Table Naming Policies'
, @mandate_database_subscriptions = 0
, @policy_category_id = @policy_category_id OUTPUT;

GO

関連項目

参照