sysmail_help_account_sp (Transact-SQL)
Listet Informationen (mit Ausnahme von Kennwörtern) zu Datenbank-E-Mail-Konten auf.
.gif "Themenlink (Symbol)")
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 vom Datentyp int. Der Standardwert ist NULL.[ @account_name = ] 'account_name'
Der Name des Kontos, für das Informationen aufgelistet werden sollen. account_name ist vom 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 |
Der 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 ist vom Datentyp bit und hat 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 auf dem SMTP-Server SSL erforderlich ist. enable_ssl ist vom Datentyp bit und hat 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
Siehe auch
Verweis
Gespeicherte Prozeduren für Datenbank-E-Mail (Transact-SQL)