sp_syspolicy_rename_policy (Transact-SQL)

適用対象: SQL Server

ポリシー ベースの管理で既存のポリシーの名前を変更します。

Transact-SQL 構文表記規則

構文

sp_syspolicy_rename_policy
    { [ @name = ] N'name' | [ @policy_id = ] policy_id }
    , [ @new_name = ] N'new_name'
[ ; ]

引数

[ @name = ] N'name'

名前を変更するポリシーの名前。 @namesysname であり、 @policy_idNULL場合は指定する必要があります。

[ @policy_id = ] policy_id

名前を変更するポリシーの識別子。 @policy_idintであり、 @nameNULL場合は指定する必要があります。

[ @new_name = ] N'new_name'

ポリシーの新しい名前。 @new_namesysname で、必須です。 NULLまたは空の文字列にすることはできません。

リターン コードの値

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

解説

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

@nameまたは@policy_idの値を指定する必要があります。 どちらも NULLすることはできません。 これらの値を取得するには、 msdb.dbo.syspolicy_policies システム ビューに対してクエリを実行します。

アクセス許可

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

重要

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

次の例では、 Test Policy 1 という名前のポリシーの名前を Test Policy 2 に変更します。

EXEC msdb.dbo.sp_syspolicy_rename_policy
    @name = N'Test Policy 1',
    @new_name = N'Test Policy 2';
GO