sysmail_help_account_sp (Transact-SQL)

2025-06-28

Van toepassing op:SQL Server

Bevat informatie (behalve wachtwoorden) over Database Mail-accounts.

Syntaxis

sysmail_help_account_sp [ [ @account_id = ] account_id | [ @account_name = ] 'account_name' ]
[ ; ]

Argumenten

[ @account_id = ] account_id

De account-id van het account waarvoor informatie moet worden vermeld. @account_id is int, met een standaardwaarde van NULL.

[ @account_name = ] 'account_name'

De naam van het account waarvoor u informatie wilt weergeven. @account_name is sysname, met een standaardwaarde van NULL.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultaatset

Retourneert een resultatenset met de onderstaande kolommen.

Kolomnaam	Gegevenstype	Beschrijving
`account_id`	Int	De id van het account.
`name`	sysname	De naam van het account.
`description`	nvarchar(256)	De beschrijving voor het account.
`email_address`	nvarchar(128)	Het e-mailadres waaruit berichten moeten worden verzonden.
`display_name`	nvarchar(128)	De weergavenaam voor het account.
`replyto_address`	nvarchar(128)	Het adres waar antwoorden op berichten van dit account worden verzonden.
`servertype`	sysname	Het type e-mailserver voor het account.
`servername`	sysname	De naam van de e-mailserver voor het account.
`port`	Int	Het poortnummer van de e-mailserver gebruikt.
`username`	nvarchar(128)	De gebruikersnaam die moet worden gebruikt om u aan te melden bij de e-mailserver als de e-mailserver gebruikmaakt van verificatie. Wanneer `username` gebruikt `NULL`Database Mail geen verificatie voor dit account.
`use_default_credentials`	bit	Hiermee geeft u op of de e-mail naar de SMTP-server moet worden verzonden met behulp van de referenties van de SQL Server Database Engine. Wanneer deze parameter is `1`, gebruikt Database Mail de referenties van de SQL Server Database Engine-service. Wanneer deze parameter is `0`, gebruikt Database Mail de @username en @password voor verificatie op de SMTP-server. Als @username en @password zijn `NULL`, gebruikt Database Mail anonieme verificatie. Neem contact op met uw SMTP-beheerder voordat u deze parameter opgeeft.
`enable_ssl`	bit	Hiermee geeft u op of Database Mail communicatie versleutelt met TLS (Transport Layer Security), voorheen bekend als SSL (Secure Sockets Layer). Gebruik deze optie als TLS is vereist op uw SMTP-server. `1` geeft aan dat Database Mail communicatie versleutelt met behulp van TLS. 0 geeft aan dat Database Mail de e-mail zonder TLS-versleuteling verzendt.

Opmerkingen

Wanneer er geen account_id of account_name wordt opgegeven, sysmail_help_account wordt informatie weergegeven over alle Database Mail-accounts in het Microsoft SQL Server-exemplaar.

De opgeslagen procedure sysmail_help_account_sp bevindt zich in de msdb database en is eigendom van het dbo-schema . De procedure moet worden uitgevoerd met een driedelige naam als de huidige database dat niet msdbis.

Machtigingen

U kunt EXECUTE machtigingen verlenen voor deze procedure, maar deze machtigingen worden mogelijk overschreven tijdens een SQL Server-upgrade.

Voorbeelden

Eén. De gegevens voor alle accounts weergeven

In het volgende voorbeeld ziet u een overzicht van de accountgegevens voor alle accounts in het exemplaar.

EXECUTE msdb.dbo.sysmail_help_account_sp;

Hier volgt een voorbeeldresultatenset, bewerkt voor regellengte:

account_id  name                         description                             email_address             display_name                     replyto_address servertype servername                port        username use_default_credentials enable_ssl
----------- ---------------------------- --------------------------------------- ------------------------- -------------------------------- --------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148         AdventureWorks Administrator Mail account for administrative e-mail. dba@adventure-works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.adventure-works.com  25          NULL 0                          0
149         Audit Account                Account for audit e-mail.               audit@adventure-works.com Automated Mailer (Audit)         NULL            SMTP       smtp.adventure-works.com  25          NULL 0                          0

B. De gegevens voor een specifiek account weergeven

In het volgende voorbeeld ziet u de accountgegevens voor het account met de naam AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_help_account_sp @account_name = 'AdventureWorks Administrator';