sp_syspolicy_configure (Transact-SQL)

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

Gilt für: SQL Server (SQL Server 2008 bis aktuelle Version).

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

• [ @name =] 'name'
  Der Name der Einstellung, die Sie konfigurieren möchten. name ist vom Datentyp sysname, ist erforderlich und darf nicht NULL oder eine leere Zeichenfolge sein.

  Für name sind die folgenden Werte möglich:

  • 'Enabled' – Gibt an, ob die richtlinienbasierte Verwaltung aktiviert ist.

  • 'HistoryRetentionInDays' – Gibt die Anzahl der Tage an, wie lange der Richtlinienauswertungsverlauf beibehalten werden soll. Bei der Einstellung 0 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 vom Datentyp sql_variant und ist erforderlich.

  • Wenn Sie name auf 'Enabled' festlegen, können Sie einen der folgenden Werte verwenden:

    • 0 = Deaktiviert die richtlinienbasierte Verwaltung.

    • 1 = Aktiviert die richtlinienbasierte Verwaltung.

  • Wenn Sie 'HistoryRetentionInDays' für name angeben, geben Sie die Anzahl der Tage als ganzzahligen Wert an.

  • Wenn Sie 'LogOnSuccess' für name festlegen, können Sie einen der folgenden Werte verwenden:

    • 0 = Protokolliert nur fehlerhafte Richtlinienauswertungen.

    • 1 = Protokolliert sowohl erfolgreiche als auch fehlerhafte Richtlinienauswertungen.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

Sie müssen sp_syspolicy_configure im Kontext der msdb-Systemdatenbank ausführen.

Um aktuelle Werte für diese Einstellungen anzuzeigen, fragen Sie die msdb.dbo.syspolicy_configuration-Systemsicht ab.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Datenbankrolle PolicyAdministratorRole.

Sicherheitshinweis

Mögliche Erweiterung der Anmeldeinformationen: Benutzer mit der PolicyAdministratorRole können Servertrigger erstellen und die Ausführung von Richtlinien planen. Dies kann sich auf die Arbeitsweise der Datenbankmodul-Instanz auswirken.Ein Benutzer mit der PolicyAdministratorRole kann beispielsweise eine Richtlinie erstellen, durch die das Erstellen der meisten Objekte in Datenbankmodul verhindert wird.Aufgrund dieser möglichen Erweiterung der Anmeldeinformationen sollte die PolicyAdministratorRole nur Benutzern gewährt werden, die hinsichtlich der Kontrolle der Konfiguration von Datenbankmodul vertrauenswürdig 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

Siehe auch

Verweis

Gespeicherte Prozeduren für die richtlinienbasierte Verwaltung (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)