Dela via


sp_syspolicy_rename_policy (Transact-SQL)

gäller för:SQL Server

Byter namn på en befintlig princip i principbaserad hantering.

Transact-SQL syntaxkonventioner

Syntax

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

Argumentpunkter

[ @name = ] N'namn'

Namnet på den princip som du vill byta namn på. @name är sysname och måste anges om @policy_id är NULL.

[ @policy_id = ] policy_id

Identifieraren för den princip som du vill byta namn på. @policy_id är int och måste anges om @name är NULL.

[ @new_name = ] N'new_name'

Det nya namnet på principen. @new_name är sysname och krävs. Får inte vara NULL eller en tom sträng.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

Du måste köra sp_syspolicy_rename_policy i kontexten för msdb-systemdatabasen.

Du måste ange ett värde för antingen @name eller @policy_id. Båda kan inte vara NULL. Hämta dessa värden genom att msdb.dbo.syspolicy_policies fråga systemvyn.

Behörigheter

Kräver medlemskap i PolicyAdministratorRole fast databasroll.

Viktigt!

Möjlig höjning av autentiseringsuppgifter: Användare i PolicyAdministratorRole roll kan skapa serverutlösare och schemalägga principkörningar som kan påverka driften av instansen av databasmotorn. Användare i PolicyAdministratorRole roll kan till exempel skapa en princip som kan förhindra att de flesta objekt skapas i databasmotorn. På grund av den här möjliga höjningen av autentiseringsuppgifterna bör PolicyAdministratorRole roll endast beviljas till användare som är betrodda med att kontrollera konfigurationen av databasmotorn.

Exempel

I följande exempel byter du namn på en princip med namnet Test Policy 1 till Test Policy 2.

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