Delen via


sp_syspolicy_configure (Transact-SQL)

van toepassing op:SQL Server-

Hiermee configureert u instellingen voor beheer op basis van beleid, bijvoorbeeld of op beleid gebaseerd beheer is ingeschakeld.

Transact-SQL syntaxisconventies

Syntaxis

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

Argumenten

[ @name = ] N'naam'

De naam van de instelling die u wilt configureren. @name is sysname, is vereist en kan niet worden NULL of een lege tekenreeks.

@name kan een van de volgende waarden zijn:

  • Enabled - Bepaalt of op beleid gebaseerd beheer is ingeschakeld.

  • HistoryRetentionInDays - Geeft het aantal dagen aan dat de beleidsevaluatiegeschiedenis moet worden bewaard. Als deze optie is ingesteld op 0, wordt de geschiedenis niet automatisch verwijderd.

  • LogOnSuccess - Hiermee geeft u op of beleidsbeheer geslaagde beleidsevaluaties registreert.

[ @value = ] waarde

De waarde die is gekoppeld aan de opgegeven waarde voor @name. @value is sql_varianten is vereist.

  • Als u Ingeschakeld opgeeft voor @name, kunt u een van de volgende waarden gebruiken:

    • 0 : hiermee schakelt u beheer op basis van beleid uit.
    • 1 : hiermee schakelt u op beleid gebaseerd beheer in.
  • Als u HistoryRetentionInDays opgeeft voor @name, geeft u het aantal dagen op als een geheel getal.

  • Als u LogOnSuccess opgeeft voor @name, kunt u een van de volgende waarden gebruiken:

    • 0 - Registreert alleen mislukte beleidsevaluaties.
    • 1 : registreert zowel geslaagde als mislukte beleidsevaluaties.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Opmerkingen

U moet sp_syspolicy_configure uitvoeren in de context van de msdb systeemdatabase.

Als u de huidige waarden voor deze instellingen wilt weergeven, voert u een query uit op de systeemweergave msdb.dbo.syspolicy_configuration.

Machtigingen

Vereist lidmaatschap van de PolicyAdministratorRole vaste databaserol.

Belangrijk

Mogelijke uitbreiding van referenties: gebruikers in de PolicyAdministratorRole--rol kunnen servertriggers maken en beleidsuitvoeringen plannen die van invloed kunnen zijn op de werking van het exemplaar van de database-engine. Gebruikers in de rol PolicyAdministratorRole kunnen bijvoorbeeld een beleid maken dat kan voorkomen dat de meeste objecten worden gemaakt in de database-engine. Vanwege deze mogelijke uitbreiding van referenties moet de rol PolicyAdministratorRole alleen worden verleend aan gebruikers die vertrouwd zijn met het beheren van de configuratie van de database-engine.

Voorbeelden

In het volgende voorbeeld wordt op beleid gebaseerd beheer ingeschakeld.

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

In het volgende voorbeeld wordt de bewaarperiode voor beleidsgeschiedenis ingesteld op 14 dagen.

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

In het volgende voorbeeld wordt op beleid gebaseerd beheer geconfigureerd om zowel geslaagde als mislukte beleidsevaluaties te registreren.

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