Dela via

sysmail_add_profile_sp (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Skapar en ny Database Mail-profil .

Transact-SQL syntaxkonventioner

Syntax

sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] N'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]
[ ; ]

Argumentpunkter

[ @profile_name = ] "profile_name"

Namnet på den nya profilen. @profile_name är sysname, utan standard.

Om du vill skicka e-post med SQL Server Agent-jobb i Azure SQL Managed Instance kan SQL Server Agent bara använda en Database Mail-profil och den måste anropas AzureManagedInstance_dbmail_profile. Mer information och ett exempelskript finns i AZURE SQL Managed Instance SQL Agent-jobbmeddelanden.

[ @description = ] Nbeskrivning

Den valfria beskrivningen för den nya profilen. @description är nvarchar(256), utan standard.

[ @profile_id = ] new_profile_id UTDATA

Returnerar ID:t för den nya profilen. @profile_id är int, med standardvärdet NULL.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

En Database Mail-profil innehåller valfritt antal Databas-e-postkonton. Lagrade procedurer för Database Mail kan referera till en profil med antingen profilnamnet eller det profil-ID som genereras av den här proceduren. Mer information om hur du lägger till ett konto i en profil finns i sysmail_add_profileaccount_sp.

Profilnamnet och beskrivningen kan ändras med den lagrade proceduren sysmail_update_profile_sp, medan profil-ID:t förblir konstant under profilens livslängd.

Profilnamnet måste vara unikt i SQL Server Database Engine-instansen eller så returnerar den lagrade proceduren ett fel.

Den lagrade proceduren sysmail_add_profile_sp finns i msdb databasen och ägs av dbo schemat. Proceduren måste köras med ett namn i tre delar om den aktuella databasen inte msdbär .

Behörigheter

Du kan bevilja EXECUTE behörigheter för den här proceduren, men dessa behörigheter kan åsidosättas under en SQL Server-uppgradering.

Exempel

A. Skapa en ny profil

I följande exempel skapas en ny Database Mail-profil med namnet AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_add_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Profile used for administrative mail.';

B. Skapa en ny profil och spara profil-ID:t i en variabel

I följande exempel skapas en ny Database Mail-profil med namnet AdventureWorks Administrator. Exemplet lagrar profil-ID-numret i variabeln @profileId och returnerar en resultatuppsättning som innehåller profil-ID-numret för den nya profilen.

DECLARE @profileId AS INT;

EXECUTE msdb.dbo.sysmail_add_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Profile used for administrative mail.',
    @profile_id = @profileId OUTPUT;

SELECT @profileId;

Relaterat innehåll