sp_syspolicy_rename_policy (Transact-SQL)

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

S'applique à : SQL Server (SQL Server 2008 jusqu'à la version actuelle).

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

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

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

• [ @new_name= ] 'new_name'
  Nouveau nom de la 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 (réussite) ou 1 (échec)

Notes

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

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

Autorisations

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

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 stratégie nommée « Test Policy 1 » en « Test Policy 2 ».

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

GO

Voir aussi

Référence

Procédures stockées de Gestion basée sur des stratégies (Transact-SQL)