sp_syspolicy_rename_policy (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Benennt in der richtlinienbasierten Verwaltung eine vorhandene Richtlinie um.

Transact-SQL-Syntaxkonventionen

Syntax

sp_syspolicy_rename_policy
    { [ @name = ] N'name' | [ @policy_id = ] policy_id }
    , [ @new_name = ] N'new_name'
[ ; ]

Argumente

[ @name = ] N'name'

Der Name der Richtlinie, die Sie umbenennen möchten. @name ist sysname und muss angegeben werden, wenn @policy_id NULL ist.

[ @policy_id = ] policy_id

Der Bezeichner für die Richtlinie, die Sie umbenennen möchten. @policy_id ist int und muss angegeben werden, wenn @name NULL ist.

[ @new_name = ] N'new_name'

Der neue Name für die Richtlinie. @new_name ist sysname und erforderlich. Darf nicht NULL oder eine leere Zeichenfolge sein.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Bemerkungen

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

Sie müssen einen Wert für @name oder @policy_id angeben. Beide können nicht NULL sein. Um diese Werte zu erhalten, fragen Sie die msdb.dbo.syspolicy_policies 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 eine Richtlinie mit dem Namen Test Policy 1 in Test Policy 2umbenannt.

EXEC msdb.dbo.sp_syspolicy_rename_policy
    @name = N'Test Policy 1',
    @new_name = N'Test Policy 2';
GO

Nächste Schritte