Freigeben über

  • Artikel

sysmail_help_account_sp (Transact-SQL)

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

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • [ @account_id = ] account_id
    Konto-ID des Kontos, für das Informationen aufgelistet werden. account_id hat den Datentyp int. Der Standardwert ist NULL.

  • [ @account_name = ] 'account_name'
    Name des Kontos, für das Informationen aufgelistet werden. account_name hat den Datentyp sysname. Der Standardwert ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

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

Spaltenname

Datentyp

Beschreibung

account_id

int

ID des Kontos

name

sysname

Name des Kontos

description

nvarchar(256)

Beschreibung des Kontos

email_address

nvarchar(128)

E-Mail-Adresse, von der aus Nachrichten versandt werden

display_name

nvarchar(128)

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. Wenn username den Wert NULL hat, verwendet Datenbank-E-Mail keine Authentifizierung für dieses Konto.

use_default_credentials

bit

Gibt an, ob E-Mail mithilfe der Anmeldeinformationen von SQL Server Database Engine (Datenbankmodul) an den SMTP-Server gesendet wird. @use_default_credentials besitzt den Datentyp bit und keinen Standardwert. Wenn dieser Parameter 1 ist, verwendet Datenbank-E-Mail keine Anmeldeinformationen des SQL Server Database Engine (Datenbankmodul)-Dienstes. Wenn dieser Parameter den Wert 0 besitzt, verwendet Datenbank-E-Mail die @username- und @password-Parameter 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 mithilfe von SSL (Secure Sockets Layer) verschlüsselt. Verwenden Sie diese Option, wenn SSL auf Ihrem SMTP-Server erforderlich ist. enable_ssl ist vom Datentyp bit und besitzt keinen Standardwert. 1 gibt an, dass Datenbank-E-Mail die Kommunikation mit SSL verschlüsselt. 0 gibt an, dass Datenbank-E-Mail die E-Mail ohne SSL-Verschlüsselung sendet.

Hinweise

Wenn keine account_id- oder account_name-Parameter bereitgestellt werden, listet sysmail_help_account Informationen für alle Datenbank-E-Mail-Konten in der Microsoft SQL Server-Instanz auf.

Die gespeicherte Prozedur sysmail_help_account_sp wird in der msdb-Datenbank gespeichert und befindet sich im Besitz des dbo-Schemas. Handelt es sich bei der aktuellen Datenbank nicht um msdb, muss die Prozedur mit einem dreiteiligen Namen ausgeführt werden.

Berechtigungen

Die Ausführungsberechtigungen für diese Prozedur erhalten standardmäßig Mitglieder der festen Serverrolle sysadmin.

Beispiele

A. Auflisten der Informationen für alle Konten

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

EXECUTE 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         AdventureWorks2008R2 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 spezifisches Konto

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

EXECUTE msdb.dbo.sysmail_help_account_sp
    @account_name = 'AdventureWorks2008R2 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         AdventureWorks2008R2 Administrator Mail account for administrative e-mail. dba@Adventure-Works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.Adventure-Works.com  25          NULL     0                       0