Share via


sp_syspolicy_rename_policy (Transact-SQL)

Cambia el nombre de una directiva existente en la administración basada en directivas.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

  • [ @name= ] 'name'
    Es el nombre de la directiva a la que desea cambiar el nombre. name es de tipo sysname y se debe especificar si policy_id es NULL.

  • [ @policy_id= ] policy_id
    Es el identificador de la directiva a la que se desea cambiar el nombre. policy_id es de tipo int y se debe especificar si name es NULL.

  • [ @new_name= ] 'new_name'
    Es el nuevo nombre de la directiva. new_name es de tipo sysname y es obligatorio. No puede ser NULL ni una cadena vacía.

Valores de los códigos de retorno

0 (correcto) o 1 (error)

Notas

Debe ejecutar sp_syspolicy_rename_policy en el contexto de la base de datos del sistema msdb.

Debe especificar un valor para name o policy_id. Ambos no pueden ser NULL. Para obtener estos valores, consulte la vista del sistema msdb.dbo.syspolicy_policies.

Permisos

Requiere la pertenencia a la función de base de datos fija PolicyAdministratorRole.

Nota de seguridadNota de seguridad

Posible elevación de credenciales: los usuarios de la función PolicyAdministratorRole pueden crear desencadenadores del servidor y programar ejecuciones de directivas que pueden afectar al funcionamiento de la instancia de Database Engine (Motor de base de datos). Por ejemplo, los usuarios de la función PolicyAdministratorRole pueden crear una directiva que puede evitar que la mayoría de los objetos se creen en Database Engine (Motor de base de datos). Debido a esta posible elevación de credenciales, la función PolicyAdministratorRole se debería conceder únicamente a los usuarios que sean de confianza para controlar la configuración de Database Engine (Motor de base de datos).

Ejemplos

En el ejemplo siguiente se cambia el nombre de una directiva que se denomina 'Test Policy 1' por 'Test Policy 2'.

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

GO