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 di 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 Policy Amministrazione istratorRole.

Importante

Possibile elevazione delle credenziali: gli utenti nel ruolo Policy Amministrazione istratorRole 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 Policy Amministrazione istratorRole possono creare criteri che possono impedire la creazione della maggior parte degli oggetti nella motore di database. A causa di questa possibile elevazione delle credenziali, il ruolo Policy Amministrazione istratorRole 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