sp_syspolicy_configure (Transact-SQL)

Configura le impostazioni della gestione basata su criteri, ad esempio se la stessa è abilitata.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_syspolicy_configure [ @name = ] 'name'
    , [ @value = ] value

Argomenti

• [ @name = ] 'name'
  Nome dell'impostazione che si desidera configurare. name è sysname, è obbligatorio e non può essere NULL o una stringa vuota.

  name può essere uno dei valori seguenti:

  • 'Enabled' - Determina se la gestione basata su criteri è abilitata.

  • 'HistoryRetentionInDays' - Specifica il numero di giorni di conservazione della cronologia di valutazione dei criteri. Se il valore è pari a 0, la cronologia non verrà rimossa automaticamente.

  • 'LogOnSuccess' - Specifica se vengono registrate le valutazioni di criteri riuscite nella gestione basata su criteri.

• [ @value = ] value
  Valore associato al valore specificato per name. value è di tipo sql_variant ed è obbligatorio.

  • Se per name viene specificato 'Enabled', è possibile utilizzare uno dei valori seguenti:

    • 0 = Disabilita la gestione basata su criteri.

    • 1 = Abilita la gestione basata su criteri.

  • Se per name viene specificato 'HistoryRententionInDays', specificare il numero di giorni come valore integer.

  • Se per name viene specificato 'LogOnSuccess', è possibile utilizzare uno dei valori seguenti:

    • 0 = Registra solo le valutazioni di criteri non riuscite.

    • 1 = Registra sia le valutazioni di criteri riuscite che quelle fallite.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

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

Per visualizzare i valori correnti di queste impostazioni, eseguire una query sulla vista di sistema msdb.dbo.syspolicy_configuration.

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del database PolicyAdministratorRole.

Nota sulla sicurezza

Possibile elevazione di credenziali: gli utenti con il ruolo PolicyAdministratorRole possono creare trigger server e pianificare le esecuzioni di criteri che influiscono sul funzionamento dell'istanza del Motore di database. Gli utenti con il ruolo PolicyAdministratorRole possono ad esempio creare criteri che impediscono la creazione della maggior parte degli oggetti nel Motore di database. A causa di questa possibile elevazione di credenziali, il ruolo PolicyAdministratorRole deve essere concesso solo a utenti ritenuti attendibili per il controllo della configurazione del Motore di database.

Esempi

Nell'esempio seguente viene abilitata la gestione basata su criteri.

EXEC msdb.dbo.sp_syspolicy_configure @name = N'Enabled'
, @value = 1;

GO

Nell'esempio seguente viene impostato un periodo di memorizzazione cronologia criteri di 14 giorni.

EXEC msdb.dbo.sp_syspolicy_configure @name = N'HistoryRetentionInDays'
, @value = 14;

GO

Nell'esempio seguente viene configurata la registrazione sia delle valutazioni di criteri riuscite che di quelle non riuscite nella gestione basata su criteri.

EXEC msdb.dbo.sp_syspolicy_configure @name = N'LogOnSuccess'
, @value = 1;

GO

Vedere anche

Riferimento

Stored procedure per la gestione basata su criteri (Transact-SQL)

sp_syspolicy_set_config_enabled (Transact-SQL)

sp_syspolicy_set_config_history_retention (Transact-SQL)

sp_syspolicy_set_log_on_success (Transact-SQL)