Condividi tramite


sp_syspolicy_add_policy_category (Transact-SQL)

Si applica a: SQL Server

Aggiunge la categoria di criteri da utilizzare con la gestione basata su criteri. Le categorie consentono di organizzare i criteri e di impostarne l'ambito.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @name = ] N'name'

Nome della categoria di criteri. @name è sysname ed è obbligatorio. @name non può essere NULL o una stringa vuota.

[ @mandate_database_subscriptions = ] mandate_database_subscriptions

Determina se la sottoscrizione di database per la categoria di criteri è obbligatoria. @mandate_database_subscriptions è un valore di bit, con un valore predefinito 1 (abilitato).

[ @policy_category_id = ] policy_category_id

Identificatore per la categoria di criteri. @policy_category_id è int e viene restituito come OUTPUT.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

È necessario eseguire sp_syspolicy_add_policy_category nel contesto del msdb database di sistema.

Autorizzazioni

Richiede l'appartenenza al ruolo predefinito del database PolicyAdministratorRole .

Importante

Possibile elevazione delle credenziali: gli utenti nel ruolo PolicyAdministratorRole possono creare trigger del server e pianificare esecuzioni di criteri che possono influire sul funzionamento dell'istanza del motore di database. Ad esempio, gli utenti nel ruolo PolicyAdministratorRole possono creare un criterio che può impedire la creazione della maggior parte degli oggetti nella motore di database. A causa di questa possibile elevazione delle credenziali, il ruolo PolicyAdministratorRole deve essere concesso solo agli utenti attendibili con il controllo della configurazione del motore di database.

Esempi

L'esempio seguente crea una categoria di criteri in cui la sottoscrizione alla categoria non è obbligatorio. È pertanto possibile configurare l'inclusione o l'esclusione di criteri nella categoria in singoli database.

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