Teilen über

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 "sysname" ist erforderlich und kann nicht NULL oder eine leere Zeichenfolge sein.

@name kann eine der folgenden Werte sein:

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

  • HistoryRetentionInDays – Gibt die Anzahl der Tage an, die der Richtlinienauswertungsverlauf beibehalten werden soll. Wenn dieser Wert auf 0"" festgelegt 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 ist 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 fehlgeschlagene Richtlinienauswertungen.
    • 1 – Protokolliert sowohl erfolgreiche als auch fehlgeschlagene Richtlinienauswertungen.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

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

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 Rechteerweiterung von Anmeldeinformationen: Benutzer in der Rolle "PolicyAdministratorRole" können Servertrigger erstellen und Richtlinienausführungen planen, die sich auf den Vorgang der Instanz der Datenbank-Engine auswirken können. Benutzer in der Rolle "PolicyAdministratorRole" können beispielsweise eine Richtlinie erstellen, die verhindert, dass die meisten Objekte im Datenbank-Engine erstellt werden. Aufgrund dieser möglichen Erhöhung von Anmeldeinformationen sollte die Rolle "PolicyAdministratorRole" nur Benutzern gewährt werden, die mit der Steuerung der Konfiguration der Datenbank-Engine vertraut sind.

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

Zugehöriger Inhalt