sysmail_help_account_sp (Transact-SQL)
Listet Informationen (mit Ausnahme von Kennwörtern) zu Datenbank-E-Mail-Konten auf.
.gif "Themenlink (Symbol)")
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 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 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 = '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