sp_syspolicy_rename_policy_category (Transact-SQL)

Si applica a: SQL Server

Rinomina una categoria di criteri esistente nella gestione basata su criteri.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @name = ] N'name'

Nome della categoria di criteri da rinominare. @name è sysname e deve essere specificato se @policy_category_id è NULL.

[ @policy_category_id = ] policy_category_id

Identificatore della categoria di criteri da rinominare. @policy_category_id è int e deve essere specificato se @name è NULL.

[ @new_name = ] N'new_name'

Nuovo nome per la categoria di criteri. @new_name è sysname ed è obbligatorio. Non può essere NULL o una stringa vuota.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

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

È necessario specificare un valore per @name o @policy_category_id. Entrambi non possono essere NULL. Per ottenere questi valori, eseguire una query sulla msdb.dbo.syspolicy_policy_categories visualizzazione 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

Nell'esempio seguente viene rinominata una categoria di criteri denominata Test Category 1 in Test Category 2.

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