sysmail_help_account_sp (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server

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

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` dies `NULL`der Fall, 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 lautet`1`, verwendet Datenbank-E-Mail die Anmeldeinformationen des SQL Server Datenbank-Engine-Diensts. Wenn dieser Parameter lautet`0`, verwendet Datenbank-E-Mail die @username und @password für die Authentifizierung auf dem SMTP-Server. Wenn @username und @password sind`NULL`, 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. `1`gibt 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

Sie können Berechtigungen für dieses Verfahren erteilen EXECUTE , aber diese Berechtigungen können 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';