Partager via


sp_syspolicy_rename_policy (Transact-SQL)

S'applique à : SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @name = ] N’name'

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

[ @policy_id = ] policy_id

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

[ @new_name = ] N’new_name'

Nouveau nom de la 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 dans le contexte de la msdb base de données système.

Vous devez spécifier une valeur pour @name ou @policy_id. Les deux ne peuvent pas être NULL. Pour obtenir ces valeurs, interrogez la msdb.dbo.syspolicy_policies 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 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