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