Share via


sp_syspolicy_add_policy_category (Transact-SQL)

Agrega una categoría de directiva que se puede utilizar con la administración basada en directivas. Las categorías de directiva le permiten organizar las directivas y establecer su ámbito.

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

Sintaxis

sp_syspolicy_add_policy_category [ @name = ] 'name'
        [ , [ @mandate_database_subscriptions = ] mandate_database_subscriptions ]
        , [ @policy_category_id = ] policy_category_id OUTPUT

Argumentos

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

  • [ @mandate_database_subscriptions = ] mandate_database_subscriptions
    Determina si la suscripción de la base de datos está asignada para la categoría de directiva. mandate_database_subscriptions es un valor de tipo bit y su valor predeterminado es 1 (habilitado).

  • [ @policy_category_id= ] policy_category_id
    Es el identificador de la categoría de directiva. policy_category_id es de tipo int y se devuelve como OUTPUT.

Valores de los códigos de retorno

0 (correcto) o 1 (error)

Notas

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

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

El ejemplo siguiente crea una categoría de directiva donde la suscripción a la categoría no está asignada. Esto significa que las bases de datos individuales se pueden configurar para participar o no en las directivas de la categoría.

DECLARE @policy_category_id int;

EXEC msdb.dbo.sp_syspolicy_add_policy_category
  @name = N'Table Naming Policies'
, @mandate_database_subscriptions = 0
, @policy_category_id = @policy_category_id OUTPUT;

GO