Partager via


sp_syspolicy_rename_policy_category (Transact-SQL)

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

Icône Lien de rubriqueConventions de syntaxe Transact-SQL

Syntaxe

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

Arguments

  • [ @name = ] 'name'
    Nom de la catégorie de stratégie que vous voulez renommer. name est de type sysname et doit être spécifié si policy_category_id a la valeur NULL.

  • [ @policy_category_id= ] policy_category_id
    Identificateur de la catégorie de stratégie que vous voulez renommer. policy_category_id est de type int et doit être spécifié si name a la valeur NULL.

  • [ @new_name= ] 'new_name'
    Nouveau nom de la catégorie de stratégie. new_name est de type sysname et est obligatoire. Ne peut pas avoir la valeur NULL ou être une chaîne vide.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

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

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

Autorisations

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

Remarque relative à la sécuritéRemarque relative à la sécurité

É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 le fonctionnement 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 création de la plupart des objets dans le moteur de base de données. Étant donné cette possible élévation des informations d'identification, le rôle PolicyAdministratorRole doit être accordé uniquement aux utilisateurs de confiance autorisés à 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