Share via

  • Artikel

sp_syspolicy_rename_policy_category (Transact-SQL)

Benennt in der richtlinienbasierten Verwaltung eine vorhandene Richtlinienkategorie um.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_syspolicy_rename_policy_category { [ @name = ] 'name' | [ @policy_category_id = ] policy_category_id }
        , [ @new_name = ] 'new_name'

Argumente

  • [ @name = ] 'name'
    Der Name der Richtlinienkategorie, die Sie umbenennen möchten. name ist vom Datentyp sysname und muss angegeben werden, wenn policy_category_id NULL ist.

  • [ @policy_category_id= ] policy_category_id
    Der Bezeichner für die Richtlinienkategorie, die Sie umbenennen möchten. policy_category_id ist vom Datentyp int und muss angegeben werden, wenn name NULL ist.

  • [ @new_name= ] 'new_name'
    Der neue Name für die Richtlinienkategorie. 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_category im Kontext der Systemdatenbank msdb ausführen.

Sie müssen einen Wert für name oder policy_category_id angeben. Keiner der Werte darf NULL sein. Um diese Werte abzurufen, fragen Sie die Systemsicht msdb.dbo.syspolicy_policy_categories 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 eine Richtlinienkategorie "Test Category 1" in "Test Category 2" umbenannt.

EXEC msdb.dbo.sp_syspolicy_rename_policy_category @name = N'Test Category 1'
, @new_name = N'Test Category 2';

GO