Teilen über


sp_syspolicy_rename_policy (Transact-SQL)

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 ist erforderlich. Kann nicht NULL oder eine leere Zeichenfolge sein.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

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

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

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