sp_syspolicy_configure (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Konfiguriert Einstellungen für richtlinienbasierte Verwaltung, z. B. ob die richtlinienbasierte Verwaltung aktiviert ist.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @name = ] N'name'

Der Name der Einstellung, die Sie konfigurieren möchten. @name ist sysname, ist erforderlich und darf nicht NULL oder eine leere Zeichenfolge sein.

@name kann einer der folgenden Werte sein:

  • Enabled – Bestimmt, ob die richtlinienbasierte Verwaltung aktiviert ist.

  • HistoryRetentionInDays – Gibt die Anzahl der Tage an, für die der Verlauf der Richtlinienauswertung beibehalten werden soll. Wenn auf 0festgelegt ist, wird der Verlauf nicht automatisch entfernt.

  • LogOnSuccess – Gibt an, ob die richtlinienbasierte Verwaltung erfolgreiche Richtlinienauswertungen protokolliert.

[ @value = ] value

Der Wert, der dem angegebenen Wert für @name zugeordnet ist. @value ist sql_variant und erforderlich.

  • Wenn Sie "Aktiviert" für @name angeben, können Sie einen der folgenden Werte verwenden:

    • 0 – Deaktiviert die richtlinienbasierte Verwaltung.
    • 1 – Aktiviert die richtlinienbasierte Verwaltung.

  • Wenn Sie für @name angebenHistoryRententionInDays, geben Sie die Anzahl der Tage als ganzzahligen Wert an.

  • Wenn Sie für @name angebenLogOnSuccess, können Sie einen der folgenden Werte verwenden:

    • 0 – Protokolliert nur fehlerhafte Richtlinienauswertungen.
    • 1 – Protokolliert sowohl erfolgreiche als auch fehlgeschlagene Richtlinienauswertungen.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Bemerkungen

Sie müssen im Kontext der msdb Systemdatenbank ausgeführt sp_syspolicy_configure werden.

Um die aktuellen Werte für diese Einstellungen anzuzeigen, fragen Sie die msdb.dbo.syspolicy_configuration Systemansicht ab.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Datenbankrolle PolicyAdministratorRole .

Wichtig

Mögliche Erhöhung der Anmeldeinformationen: Benutzer mit der Rolle PolicyAdministratorRole können Servertrigger erstellen und Richtlinienausführungen planen, die sich auf den Betrieb der instance der Datenbank-Engine auswirken können. Beispielsweise können Benutzer mit der Rolle PolicyAdministratorRole eine Richtlinie erstellen, die verhindern kann, dass die meisten Objekte in der Datenbank-Engine erstellt werden. Aufgrund dieser möglichen Erhöhung der Anmeldeinformationen sollte die Rolle PolicyAdministratorRole nur Benutzern gewährt werden, denen die Steuerung der Konfiguration der Datenbank-Engine vertraut ist.

Beispiele

Im folgenden Beispiel wird die richtlinienbasierte Verwaltung aktiviert.

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

Im folgenden Beispiel wird die Richtlinienverlaufsbeibehaltung auf 14 Tage festgelegt.

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

Im folgenden Beispiel wird die richtlinienbasierte Verwaltung so konfiguriert, dass sowohl erfolgreiche als auch fehlerhafte Richtlinienauswertungen protokolliert werden.

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

Nächste Schritte