Partager via


sp_syspolicy_rename_policy_category (Transact-SQL)

S'applique à : SQL Server

Renomme une catégorie de stratégie existante dans la Gestion basée sur des stratégies.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_syspolicy_rename_policy_category
    { [ @name = ] N'name' | [ @policy_category_id = ] policy_category_id }
    , [ @new_name = ] N'new_name'
[ ; ]

Arguments

[ @name = ] N’name'

Nom de la catégorie de stratégie à renommer. @name est sysname et doit être spécifié si @policy_category_id est NULL.

[ @policy_category_id = ] policy_category_id

Identificateur de la catégorie de stratégie que vous souhaitez renommer. @policy_category_id est int et doit être spécifié si @name est NULL.

[ @new_name = ] N’new_name'

Nouveau nom pour la catégorie de stratégie. @new_name est sysname et est obligatoire. Ne peut pas être NULL ou une chaîne vide.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

Vous devez exécuter sp_syspolicy_rename_policy_category dans le contexte de la msdb base de données système.

Vous devez spécifier une valeur pour @name ou @policy_category_id. Les deux ne peuvent pas être NULL. Pour obtenir ces valeurs, interrogez la msdb.dbo.syspolicy_policy_categories vue système.

autorisations

Nécessite l’appartenance au rôle de base de données fixe PolicyAdministratorRole .

Important

Élévation possible des informations d’identification : les utilisateurs du rôle PolicyAdministratorRole peuvent créer des déclencheurs de serveur et planifier des exécutions de stratégie qui peuvent affecter l’opération de l’instance du Moteur de base de données. Par exemple, les utilisateurs du rôle PolicyAdministratorRole peuvent créer une stratégie qui peut empêcher la plupart des objets d’être créés dans le Moteur de base de données. En raison de cette élévation possible d’informations d’identification, le rôle PolicyAdministratorRole doit être accordé uniquement aux utilisateurs approuvés pour contrôler la configuration du Moteur de base de données.

Exemples

L’exemple suivant renomme une catégorie de stratégie nommée Test Category 1 en Test Category 2.

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