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. 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 msdb
vorhanden 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 Administrator
aufgelistet.
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