Een database-e-mailprofiel maken

Artikel
03/05/2025

van toepassing op:SQL Server Azure SQL Managed Instance

Gebruik de Database Mail Configuration Wizard of Transact-SQL om openbare en privé databaseprofielen te maken. Zie Database Mail Profilevoor meer informatie over e-mailprofielen.

Voordat u begint

Voorwaarden

Maak een of meer Database Mail-accounts voor het profiel. Zie Een database-e-mailaccount makenvoor meer informatie over het maken van Database Mail-accounts.

Veiligheid

Met een openbaar profiel kan elke gebruiker met toegang tot de msdb-database e-mail verzenden met dat profiel. Een privéprofiel kan worden gebruikt door een gebruiker of door een rol. Door rollen toegang te verlenen tot profielen, wordt een eenvoudiger onderhouden architectuur gemaakt. Als u e-mail wilt verzenden, moet u lid zijn van de DatabaseMailUserRole- in de msdb-database en toegang hebben tot ten minste één Database Mail-profiel.

Machtigingen

De gebruiker die de profielenaccounts maakt en opgeslagen procedures uitvoert, moet lid zijn van de vaste serverfunctie sysadmin.

Wizard Database Mail-configuratie gebruiken

Een Database Mail-profiel maken

Maak in Objectverkenner verbinding met het SQL Server-exemplaar waarop u Database Mail wilt configureren en vouw de serverstructuur uit.
Vouw het knooppunt Management uit
Dubbelklik op Database Mail om de wizard Database Mail configureren te openen.
Selecteer op de pagina Configuratietaak selecteren de optie Database-e-mailaccounts en -profielen beheren en selecteer vervolgens Volgende.
Selecteer op de pagina Beheer profielen en accounts de optie Een nieuw profiel maken en selecteer daarna Volgende.
Geef op de pagina Nieuw profiel de profielnaam, beschrijving en accounts toe die in het profiel moeten worden opgenomen en selecteer Volgende.
Controleer op de pagina De wizard voltooien de acties die uitgevoerd moeten worden en selecteer Voltooien om het maken van het nieuwe profiel te voltooien.
Een privéprofiel voor Database Mail configureren:
- Open de configuratiewizard voor Database Mail.
- Selecteer op de pagina Selectie van configuratietaak de optie Database-e-mailaccounts en -profielen beheren en selecteer Volgende.
- Selecteer op de pagina Profielen en accounts beheren de optie Profielbeveiliging beheren en kies vervolgens Volgende.
- Schakel op het tabblad Privéprofielen het selectievakje in voor het profiel dat u wilt configureren en selecteer Volgende.
- Controleer op de pagina Wizard voltooien de acties die moeten worden uitgevoerd en selecteer Voltooien om de configuratie van het profiel te voltooien.
Een openbaar Database Mail-profiel configureren:
- Open de Database Mail-configuratiewizard.
- Selecteer op de pagina Configuratietaak selecteren de optie Database-e-mailaccounts en -profielen beheren en selecteer Volgende.
- Selecteer op de pagina Profielen en accounts beheren de optie Profielbeveiliging beheren en selecteer Volgende.
- Schakel op het tabblad Openbare profielen het selectievakje in voor het profiel dat u wilt configureren en selecteer Volgende.
- Op de pagina De wizard voltooien, controleer de acties die moeten worden uitgevoerd en selecteer Voltooien om het profiel configureren te voltooien.

Gebruik Transact-SQL

Een privéprofiel voor database-e-mail maken

Maak verbinding met het SQL Server-exemplaar met SQL Server Management Studio (SSMS) of Azure Data Studio. Open een nieuw queryvenster.
Als u een nieuw profiel wilt maken, voert u de door het systeem opgeslagen procedure sysmail_add_profile_sp (Transact-SQL ) als volgt uit:
```
EXECUTE msdb.dbo.sysmail_add_profile_sp
  @profile_name = 'Profile Name'  
, @description = 'Description';
```
In het vorige script is @profile_name de naam van het profiel en @description de beschrijving van het profiel. Deze parameter is optioneel.
Voer voor elk account de opgeslagen procedure uit sysmail_add_profileaccount_sp (Transact-SQL) als volgt uit:
```
EXECUTE msdb.dbo.sysmail_add_profileaccount_sp
  @profile_name = 'Profile Name'
, @account_name = 'Name of the account'  
, @sequence_number = 'sequence number of the account within the profile.';
```
In het vorige voorbeeldscript is @profile_name de naam van het profiel en @account_name de naam is van het account dat u aan het profiel wilt toevoegen, @sequence_number bepaalt de volgorde waarin de accounts in het profiel worden gebruikt.
Voor elke databaserol of gebruiker die e-mail verzendt met dit profiel, verleent u toegang tot het profiel. Voer hiervoor de opgeslagen procedure sysmail_add_principalprofile_sp (Transact-SQL ) als volgt uit:
```
EXECUTE msdb.sysmail_add_principalprofile_sp
 @profile_name = 'Name of the profile'
, @principal_name = 'Name of the database user or role'  
, @is_default = 'Default profile enabled';
```
In het vorige voorbeeldscript is @profile_name de naam van het profiel, @principal_name de naam van de databasegebruiker of -rol is en @is_default bepaalt of dit profiel de standaardwaarde is voor de databasegebruiker of -rol.

In het volgende voorbeeld wordt een Database Mail-account gemaakt, een privéprofiel voor Database Mail gemaakt, vervolgens het account aan het profiel toegevoegd en toegang verleend tot het profiel aan de DBMailUsers databaserol in de msdb-database.

-- Create a Database Mail account  
EXECUTE msdb.dbo.sysmail_add_account_sp  
    @account_name = 'AdventureWorks Administrator',  
    @description = 'Mail account for administrative e-mail.',  
    @email_address = 'dba@Adventure-Works.com',  
    @replyto_address = 'danw@Adventure-Works.com',  
    @display_name = 'AdventureWorks Automated Mailer',  
    @mailserver_name = 'smtp.Adventure-Works.com' ;  
  
-- Create a Database Mail profile  
EXECUTE msdb.dbo.sysmail_add_profile_sp  
    @profile_name = 'AdventureWorks Administrator Profile',  
    @description = 'Profile used for administrative mail.' ;  
  
-- Add the account to the profile  
EXECUTE msdb.dbo.sysmail_add_profileaccount_sp  
    @profile_name = 'AdventureWorks Administrator Profile',  
    @account_name = 'AdventureWorks Administrator',  
    @sequence_number =1 ;  
  
-- Grant access to the profile to the DBMailUsers role  
EXECUTE msdb.dbo.sysmail_add_principalprofile_sp  
    @profile_name = 'AdventureWorks Administrator Profile',  
    @principal_name = 'ApplicationUser',  
    @is_default = 1 ;

Een openbaar database-e-mailprofiel maken

Maak verbinding met het SQL Server-exemplaar.
Als u een nieuw profiel wilt maken, voert u de door het systeem opgeslagen procedure sysmail_add_profile_sp (Transact-SQL ) als volgt uit:
```
EXECUTE msdb.dbo.sysmail_add_profile_sp
  @profile_name = 'Profile Name'  
, @description = 'Description';
```
In het vorige script is @profile_name de naam van het profiel en @description de beschrijving van het profiel. Deze parameter is optioneel.
Voer voor elk account de opgeslagen procedure uit sysmail_add_profileaccount_sp (Transact-SQL) als volgt uit:
```
EXECUTE msdb.dbo.sysmail_add_profileaccount_sp
  @profile_name = 'Name of the profile'  
, @account_name* = 'Name of the account'  
, @sequence_number* = 'sequence number of the account within the profile.'  
```
In het vorige voorbeeldscript is @profile_name de naam van het profiel en @account_name de naam is van het account dat u aan het profiel wilt toevoegen, @sequence_number bepaalt de volgorde waarin de accounts in het profiel worden gebruikt.
Als u openbare toegang wilt verlenen, voert u de opgeslagen procedure sysmail_add_principalprofile_sp (Transact-SQL ) als volgt uit:
```
EXECUTE msdb.sysmail_add_principalprofile_sp
  @profile_name = 'Name of the profile' 
, @principal_name = 'public or 0'  
, @is_default = 'Default Profile enabled';
```
In het vorige voorbeeldscript is @profile_name de naam van het profiel en @principal_name om aan te geven dat dit een openbaar profiel is, @is_default bepaalt of dit profiel de standaardwaarde is voor de databasegebruiker of -rol.

In het volgende voorbeeld wordt een Database Mail-account gemaakt, een privéprofiel voor Database Mail gemaakt, vervolgens het account aan het profiel toegevoegd en openbare toegang tot het profiel verleend.

-- Create a Database Mail account  
EXECUTE msdb.dbo.sysmail_add_account_sp  
    @account_name = 'AdventureWorks Public Account',  
    @description = 'Mail account for use by all database users.',  
    @email_address = 'db_users@Adventure-Works.com',  
    @replyto_address = 'danw@Adventure-Works.com',  
    @display_name = 'AdventureWorks Automated Mailer',  
    @mailserver_name = 'smtp.Adventure-Works.com' ;  
  
-- Create a Database Mail profile  
  EXECUTE msdb.dbo.sysmail_add_profile_sp  
    @profile_name = 'AdventureWorks Public Profile',  
    @description = 'Profile used for administrative mail.' ;  

-- Add the account to the profile  
EXECUTE msdb.dbo.sysmail_add_profileaccount_sp  
    @profile_name = 'AdventureWorks Public Profile',  
    @account_name = 'AdventureWorks Public Account',  
    @sequence_number =1 ;  
  
-- Grant access to the profile to all users in the msdb database  
EXECUTE msdb.dbo.sysmail_add_principalprofile_sp  
    @profile_name = 'AdventureWorks Public Profile',  
    @principal_name = 'public',  
    @is_default = 1 ;

Delen via