Delen via


sp_syspolicy_rename_policy (Transact-SQL)

Van toepassing op:SQL Server

Wijzigt de naam van een bestaand beleid in beheer op basis van beleid.

Transact-SQL syntaxis-conventies

Syntaxis

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

Argumenten

[ @name = ] N'naam'

De naam van het beleid waarvan u de naam wilt wijzigen. @nameis sysname en moet worden opgegeven als @policy_id is NULL.

[ @policy_id = ] policy_id

De id voor het beleid dat u wilt wijzigen. @policy_id is int en moet worden opgegeven als @name is NULL.

[ @new_name = ] N'new_name'

De nieuwe naam voor het beleid. @new_name is sysname en is vereist. Kan geen of een lege tekenreeks zijn NULL .

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Opmerkingen

U moet sp_syspolicy_rename_policy uitvoeren in de context van de msdb systeemdatabase.

U moet een waarde opgeven voor @name of @policy_id. Beide kunnen niet zijn NULL. Als u deze waarden wilt verkrijgen, voert u een query uit op de msdb.dbo.syspolicy_policies systeemweergave.

Machtigingen

Vereist lidmaatschap van de PolicyAdministratorRole vaste databaserol.

Belangrijk

Mogelijke uitbreiding van referenties: gebruikers in de PolicyAdministratorRole--rol kunnen servertriggers maken en beleidsuitvoeringen plannen die van invloed kunnen zijn op de werking van het exemplaar van de database-engine. Gebruikers in de rol PolicyAdministratorRole kunnen bijvoorbeeld een beleid maken dat kan voorkomen dat de meeste objecten worden gemaakt in de database-engine. Vanwege deze mogelijke uitbreiding van referenties moet de rol PolicyAdministratorRole alleen worden verleend aan gebruikers die vertrouwd zijn met het beheren van de configuratie van de database-engine.

Voorbeelden

In het volgende voorbeeld wordt de naam van een beleid gewijzigd Test Policy 1Test Policy 2in .

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