Teilen über


sysmail_help_account_sp (Transact-SQL)

Gilt für: SQL Server

Listet Informationen (mit Ausnahme von Kennwörtern) zu Datenbank-E-Mail-Konten auf.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @account_id = ] account_id

Die Konto-ID des Kontos, für das Informationen aufgelistet werden sollen. @account_id ist int, mit einem Standardwert von NULL.

[ @account_name = ] 'account_name'

Der Name des Kontos, für das Informationen aufgelistet werden sollen. @account_name ist "sysname" mit der Standardeinstellung "NULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Gibt ein Resultset mit den nachfolgend aufgelisteten Spalten zurück.

Spaltenname Datentyp BESCHREIBUNG
account_id int ID des Kontos
name sysname Der Kontoname.
description nvarchar(256) Beschreibung des Kontos
email_address nvarchar(128) E-Mail-Adresse, von der aus Nachrichten versandt werden
display_name nvarchar(128) Der Anzeigename des Kontos.
replyto_address nvarchar(128) Adresse, an die Antworten auf die Nachrichten von diesem Konto versandt werden
servertype sysname Typ des E-Mail-Servers für das Konto
servername sysname Name des E-Mail-Servers für das Konto
port int Portnummer, die der E-Mail-Server verwendet
username nvarchar(128) Der Benutzername für die Anmeldung am E-Mail-Server, wenn der E-Mail-Server eine Authentifizierung verwendet. Ist username NULL, verwendet Datenbank-E-Mail keine Authentifizierung für dieses Konto.
use_default_credentials bit Gibt an, ob die E-Mail mithilfe der Anmeldeinformationen des SQL Server-Datenbank-Engine an den SMTP-Server gesendet werden soll. Wenn dieser Parameter lautet1, verwendet Datenbank-E-Mail die Anmeldeinformationen des SQL Server Datenbank-Engine-Diensts. Wenn dieser Parameter lautet0, verwendet Datenbank-E-Mail die @username und @password für die Authentifizierung auf dem SMTP-Server. Wenn @username und @password NULL sind, verwendet Datenbank-E-Mail anonyme Authentifizierung. Wenden Sie sich an Ihren SMTP-Administrator, bevor Sie diesen Parameter angeben.
enable_ssl bit Gibt an, ob Datenbank-E-Mail die Kommunikation mit Transport Layer Security (TLS) verschlüsselt, die zuvor als Secure Sockets Layer (SSL) bezeichnet wurde. Verwenden Sie diese Option, wenn TLS auf Ihrem SMTP-Server erforderlich ist. 1gibt an, Datenbank-E-Mail die Kommunikation mithilfe von TLS verschlüsselt. 0 gibt an, Datenbank-E-Mail die E-Mail ohne TLS-Verschlüsselung sendet.

Hinweise

Wenn kein account_id oder account_name bereitgestellt wird, sysmail_help_account werden Informationen zu allen Datenbank-E-Mail Konten in der Microsoft SQL Server-Instanz aufgelistet.

Die gespeicherte Prozedur sysmail_help_account_sp befindet sich in der msdb Datenbank und befindet sich im Besitz des dbo-Schemas . Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn die aktuelle Datenbank nicht msdbvorhanden ist.

Berechtigungen

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Beispiele

A. Auflisten der Informationen für alle Konten

Im folgenden Beispiel werden die Kontodaten für alle Konten in der Instanz aufgelistet.

EXEC msdb.dbo.sysmail_help_account_sp;

Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde:

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. Auflisten der Informationen für ein bestimmtes Konto

Im folgenden Beispiel werden die Kontodaten für das Konto mit dem Namen AdventureWorks Administratoraufgelistet.

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

Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde:

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