Definieren eines SMTP-Übermittlungskanals
Ein SMTP-Übermittlungskanal definiert einen SMTP-Serverendpunkt für das Übermitteln von Benachrichtigungen mithilfe des SMTP-Übermittlungsprotokolls. Wenn Sie in einer von der Instanz gehosteten Anwendung das integrierte SMTP-Übermittlungsprotokoll verwenden, müssen Sie mindestens einen SMTP-Übermittlungskanal definieren.
Hinweis: |
---|
Aufgrund der von Microsoft .NET Framework verwendeten SMTP-Implementierung können Sie nur einen SMTP-Übermittlungskanal pro Instanz definieren. Wenn Sie zwei SMTP-Übermittlungskanäle definieren, werden die Benachrichtigungen möglicherweise an die falschen SMTP-Server übermittelt. |
Hinweis: |
---|
Stellen Sie sicher, einen Wert für das SmtpServer-Argument anzugeben, um den lokalen SMTP-Dienst von Internetinformationsdienste (IIS, Internet Information Services) zu verwenden. Andernfalls muss das Konto, unter dem der NS$instanceName-Dienst ausgeführt wird, ein Mitglied der lokalen Gruppe Administratoren sein. |
SMTP-Übermittlungskanaleigenschaften
Beim Definieren eines Übermittlungskanals für das SMTP-Übermittlungsprotokoll müssen Sie bestimmte Werte in den Elementen ProtocolName und Arguments verwenden. In der folgenden Liste sind die Elemente und die Werte, die für das SMTP-Übermittlungsprotokoll erforderlich sind, beschrieben:
- Der Übermittlungskanalname muss innerhalb der Notification Services-Instanz eindeutig sein und darf nicht die folgenden Zeichen enthalten: öffnende eckige Klammer ([), schließende eckige Klammer (]), Anführungszeichen ("), einfaches Anführungszeichen ('), umgekehrter Schrägstrich (\) und Schrägstrich (/).
- Der Protokollname muss SMTP lauten.
- Das SMTP-Übermittlungsprotokoll verwendet zwei Argumente:
- Geben Sie den SMTP-Server für den Übermittlungskanal an. Der Argumentname muss SmtpServer lauten. Der Wert muss dem Namen eines SMTP-Servers oder eines Weiterleitungsservers, z. B. eines Smarthosts, entsprechen. Wenn Sie einen Weiterleitungsserver verwenden, können Sie das Einreihen in lokale E-Mail-Warteschlangen vermeiden.
- Geben Sie die für den SMTP-Server erforderliche Textcodierung an. Der Argumentname muss BodyEncoding lauten. Der Wert muss einem gültigen Codierungsformat entsprechen. Alle Codierungsformate, die von der GetEncoding-Methode der Encoding-Klasse in Microsoft .NET Framework zurückgegeben werden, sind gültig (
us-ascii
,utf-7
,utf-8
,utf-16
undunicodeFFFE
).
Für Unicode-Daten wird in der Regel der Wertutf-8
verwendet.
Hinweis: |
---|
Sie können für den SMTP-Server als Teil der Übermittlungskanalkonfiguration keine Verbindungsinformationen (wie z. B. Name und Kennwort) angeben. Das Betriebssystem stellt Verbindungen mit dem SMTP-Server mithilfe des Dienstkontos her. |
Beispiele
Die folgenden Beispiele zeigen, wie SMTP-Übermittlungskanäle in Instanzkonfigurationsdateien (ICFs, Instance Configuration Files) definiert werden.
SMTP-Server
Das folgende Beispiel zeigt, wie ein Übermittlungskanal für das integrierte SMTP-Übermittlungsprotokoll definiert wird. Da das SMTP-Übermittlungsprotokoll integriert ist, benötigt es kein entsprechendes Element im Protocols-Element der ICF.
<DeliveryChannels>
<DeliveryChannel>
<DeliveryChannelName>SMTPServer01</DeliveryChannelName>
<ProtocolName>SMTP</ProtocolName>
<Arguments>
<Argument>
<Name>SmtpServer</Name>
<Value>MailServer01</Value>
</Argument>
<Argument>
<Name>BodyEncoding</Name>
<Value>utf-16</Value>
</Argument>
</Arguments>
</DeliveryChannel>
</DeliveryChannels>
Verwenden von Smarthost zum Übertragen von Nachrichten
Das folgende Beispiel zeigt, wie der lokale SMTP-Dienst von IIS mit der Smarthostoption zum Übertragen von Nachrichten verwendet wird. Konfigurieren Sie zunächst den lokalen SMTP-Dienst von IIS für das Übertragen von Nachrichten, und konfigurieren Sie dann den SMTP-Übermittlungskanal wie folgt.
<DeliveryChannel>
<DeliveryChannelName>EmailChannel</DeliveryChannelName>
<ProtocolName>SMTP</ProtocolName>
</DeliveryChannel>
Weitere Informationen zum Konfigurieren des SMTP-Dienstes von IIS finden Sie unter Using SMTP for Outgoing Messages (in Englisch) auf der Technet-Website.
Siehe auch
Konzepte
SMTP-Übermittlungsprotokoll
Definieren von Übermittlungskanälen
Andere Ressourcen
Instance Configuration File Templates
Konfigurieren von Instanzen von Notification Services