sysmail_update_account_sp (Transact-SQL)

Syntax

sysmail_update_account_sp [ [ @account_id = ] account_id ] [ , ] [ [ @account_name = ] 'account_name' ] ,
    [ @email_address = ] 'email_address' , 
    [ @display_name = ] 'display_name' , 
    [ @replyto_address = ] 'replyto_address' ,
    [ @description = ] 'description' , 
    [ @mailserver_name = ] 'server_name' , 
    [ @mailserver_type = ] 'server_type' , 
    [ @port = ] port_number , 
    [ @username = ] 'username' ,
    [ @password = ] 'password' ,
    [ @use_default_credentials = ] use_default_credentials ,
    [ @enable_ssl = ] enable_ssl 

Argumente

• [ @account_id = ] account_id
  Die zu aktualisierende Konto-ID. account_id ist ein Wert vom Datentyp int; der Standardwert ist NULL. Es muss mindestens account_id oder account_name angegeben werden (es können auch beide angegeben werden). Wenn beide Argumente angegeben werden, ändert die Prozedur den Namen des Kontos.

• [ @account_name = ] 'account_name'
  Der Name des zu aktualisierenden Kontos. account_name ist ein Wert vom Datentyp sysname; der Standardwert ist NULL. Es muss mindestens account_id oder account_name angegeben werden (es können auch beide angegeben werden). Wenn beide Argumente angegeben werden, ändert die Prozedur den Namen des Kontos.

• [ @email_address = ] 'email_address'
  Die neue E-Mail-Adresse, von der die Nachricht gesendet werden soll. Bei dieser Adresse muss es sich um eine Internet-E-Mail-Adresse handeln. Der Servername ist die Adresse des Servers, der von Datenbank-E-Mail zum Senden von E-Mails von diesem Konto verwendet wird. email_address ist ein Wert vom Datentyp nvarchar(128); der Standardwert ist NULL.

• [ @display_name = ] 'display_name'
  Der neue Anzeigename, der in E-Mail-Nachrichten verwendet werden soll, die von diesem Konto gesendet werden. display_name ist ein Wert vom Datentyp nvarchar(128) und hat keinen Standardwert.

• [ @replyto_address = ] 'replyto_address'
  Die neue Adresse, die im Antwortheader von E-Mail-Nachrichten verwendet werden soll, die von diesem Konto gesendet werden. replyto_address ist ein Wert vom Datentyp nvarchar(128) und hat keinen Standardwert.

• [ @description = ] 'description'
  Die neue Beschreibung für das Konto. description ist ein Wert vom Datentyp nvarchar(256); der Standardwert ist NULL.

• [ @mailserver_name = ] 'server_name'
  Der neue Name des SMTP-Mailservers, der für dieses Konto verwendet werden soll. Der Computer, auf dem SQL Server ausgeführt wird, muss in der Lage sein, server_name in eine IP-Adresse aufzulösen. server_name ist ein Wert vom Datentyp sysname und hat keinen Standardwert.

• [ @mailserver_type = ] 'server_type'
  Der neue Typ des Mailservers. server_type ist ein Wert vom Datentyp sysname und hat keinen Standardwert. Für SQL Server 2005 und später wird nur der Wert 'SMTP' unterstützt.

• [ @port = ] port_number
  Die neue Portnummer des Mailservers. port_number ist ein Wert vom Datentyp int und hat keinen Standardwert.

• [ @username = ] 'username'
  Der neue Benutzername, der für die Anmeldung am E-Mail-Server verwendet wird. User name ist ein Wert vom Datentyp sysname und besitzt keinen Standardwert.

• [ @password = ] 'password'
  Das neue Kennwort, das für die Anmeldung am Mailserver verwendet wird. password ist ein Wert vom Datentyp sysname und hat keinen Standardwert.

• [ @use_default_credentials = ] use_default_credentials
  Gibt an, ob E-Mail-Nachrichten mithilfe der Anmeldeinformationen des SQL Server Database Engine (Datenbankmodul)-Diensts an den SMTP-Server gesendet werden sollen. use_default_credentials ist vom Datentyp bit und hat keinen Standardwert. Wenn dieser Parameter 1 ist, verwendet Datenbank-E-Mail die Anmeldeinformationen von Database Engine (Datenbankmodul). Wenn dieser Parameter 0 ist, verwendet Datenbank-E-Mail die für die Authentifizierung beim SMTP-Server für @username und @password angegebenen Werte. Wenn @username und @password NULL sind, verwendet das Konto die anonyme Authentifizierung. Besprechen Sie die geeignete Angabe für diesen Parameter mit Ihrem SMTP-Administrator.

• [ @enable_ssl = ] enable_ssl
  Gibt an, ob Datenbank-E-Mail die Kommunikation mithilfe von SSL (Secure Sockets Layer) verschlüsseln soll. Verwenden Sie diese Option, wenn SSL auf Ihrem SMTP-Server erforderlich ist. enable_ssl ist vom Datentyp bit und hat keinen Standardwert.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

Wenn sowohl Kontoname als auch Konto-ID angegeben wird, aktualisiert die gespeicherte Prozedur nicht nur die Informationen für das Konto, sondern ändert auch noch den Kontonamen. Die Änderung des Kontonamens kann hilfreich sein, wenn ein fehlerhafter Kontoname korrigiert werden soll.

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

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin.

Beispiele

A. Ändern der Informationen für ein Konto

EXECUTE msdb.dbo.sysmail_update_account_sp
    ,@account_name = 'AdventureWorks2008R2 Administrator'
    ,@description = 'Mail account for administrative e-mail.'
    ,@email_address = 'dba@Adventure-Works.com'
    ,@display_name = 'AdventureWorks Automated Mailer'
    ,@replyto_address = NULL
    ,@mailserver_name = 'smtp.Adventure-Works.com'
    ,@mailserver_type = 'SMTP'
    ,@port = 25
    ,@username = NULL
    ,@password = NULL
    ,@use_default_credentials = 0
    ,@enable_ssl = 0;

B. Ändern des Namens eines Kontos und der Informationen für ein Konto

EXECUTE msdb.dbo.sysmail_update_account_sp
    ,@account_id = 125
    ,@account_name = 'Backup Mail Server'
    ,@description = 'Mail account for administrative e-mail.'
    ,@email_address = 'dba@Adventure-Works.com'
    ,@display_name = 'AdventureWorks Automated Mailer'
    ,@replyto_address = NULL
    ,@mailserver_name = 'smtp-backup.Adventure-Works.com'
    ,@mailserver_type = 'SMTP'
    ,@port = 25,
    ,@username = NULL
    ,@password = NULL
    ,@use_default_credentials = 0
    ,@enable_ssl = 0;

Siehe auch

Verweis

Konzepte