sp_syspolicy_configure (Transact-SQL)
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 keine leere Zeichenfolge seinNULL
.
@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 auf0
"" 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 angeben
HistoryRententionInDays
, geben Sie die Anzahl der Tage als ganzzahligen Wert an.Wenn Sie für @name angeben
LogOnSuccess
, 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