Share via


sp_syspolicy_rename_policy (Transact-SQL)

Benennt in der richtlinienbasierten Verwaltung eine vorhandene Richtlinie um.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • [ @name= ] 'name'
    Der Name der Richtlinie, die Sie umbenennen möchten. name ist vom Datentyp 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= ] 'new_name'
    Der neue Name für die Richtlinie. new_name ist vom Datentyp sysname und ist erforderlich. Darf nicht NULL und keine leere Zeichenfolge sein.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

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

Sie müssen einen Wert für name oder policy_id angeben. Keiner der Werte darf NULL sein. Um diese Werte abzurufen, fragen Sie die Systemsicht msdb.dbo.syspolicy_policies ab.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Datenbankrolle PolicyAdministratorRole.

SicherheitshinweisSicherheitshinweis

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 Richtlinie "Test Policy 1" in "Test Policy 2" umbenannt.

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

GO