sp_syspolicy_rename_policy_category (Transact-SQL)

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

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

• [ @name = ] 'name'
  Es el nombre de la categoría de directiva cuyo nombre se desea cambiar. name es de tipo sysname y debe especificarse si policy_category_id es NULL.

• [ @policy_category_id= ] policy_category_id
  Es el identificador de la categoría de directiva cuyo nombre se desea cambiar. policy_category_id es de tipo int y debe especificarse si name es NULL.

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

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

Se debe ejecutar sp_syspolicy_rename_policy_category en el contexto de la base de datos del sistema msdb.

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

Permisos

Requiere la pertenencia al rol fijo de base de datos PolicyAdministratorRole.

Nota de seguridad

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

Ejemplos

En el ejemplo siguiente se cambia el nombre de una categoría de directiva que se denomina 'Test Category 1' a 'Test Category 2'.

EXEC msdb.dbo.sp_syspolicy_rename_policy_category @name = N'Test Category 1'
, @new_name = N'Test Category 2';

GO

Vea también

Referencia

Procedimientos almacenados de la administración basada en directivas (Transact-SQL)

sp_syspolicy_add_policy_category (Transact-SQL)

sp_syspolicy_delete_policy_category (Transact-SQL)

sp_syspolicy_update_policy_category (Transact-SQL)