sp_syspolicy_configure (Transact-SQL)

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 Systemdatenbank msdb ausführen.

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

Berechtigungen

Erfordert die Mitgliedschaft in der festen Datenbankrolle PolicyAdministratorRole.

Sicherheitshinweis

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