Definizione di un canale di recapito SMTP
Un canale di recapito SMTP definisce un endpoint del server SMTP per il recapito delle notifiche tramite il protocollo di recapito SMTP. Se si utilizza il protocollo di recapito SMTP predefinito in un'applicazione ospitata dall'istanza, è necessario definire almeno un canale di recapito SMTP.
[!NOTA] Nell'implementazione di SMTP utilizzata da Microsoft .NET Framework è possibile definire un solo canale di recapito SMTP per istanza. Se si definiscono due canali di recapito SMTP, è possibile che le notifiche vengano recapitate in server SMTP non corretti.
[!NOTA] Per utilizzare il servizio SMTP locale di Internet Information Services (IIS), specificare un valore per l'argomento SmtpServer. In caso contrario, l'account utilizzato per l'esecuzione del servizio NS$instanceName deve essere membro del gruppo Administrators locale.
Proprietà dei canali di recapito SMTP
Quando si definisce un canale di recapito per il protocollo di recapito SMTP, è necessario utilizzare valori specifici negli elementi ProtocolName e Arguments. Nell'elenco riportato di seguito vengono descritti gli elementi e i valori necessari per il protocollo di recapito SMTP:
- Il nome del canale di recapito deve essere univoco nell'istanza di Notification Services e non può contenere i caratteri seguenti: parentesi quadra di apertura ([), parentesi quadra di chiusura (]), virgolette doppie ("), virgolette singole ('), barra rovesciata (\) e barra (/).
- Il nome del protocollo deve essere SMTP.
- Il protocollo di recapito SMTP utilizza due argomenti:
- Specificare il server SMTP per il canale di recapito. Il nome dell'argomento deve essere SmtpServer. Il valore deve corrispondere al nome di un server SMTP o di un server di inoltro, ad esempio uno smart host. Se si utilizza un server di inoltro, è possibile evitare le code di posta elettronica locali.
- Specificare la codifica del corpo necessaria per il server SMTP. Il nome dell'argomento deve essere BodyEncoding. Il valore deve essere un formato di codifica valido. Tutti i formati di codifica restituiti dal metodo GetEncoding della classe Encoding in Microsoft .NET Framework sono validi (
us-ascii
,utf-7
,utf-8
,utf-16
eunicodeFFFE
).
I dati Unicode utilizzano in genere il valoreutf-8
.
[!NOTA] Non è possibile specificare informazioni di connessione, ad esempio il nome e la password, per il server SMTP come parte della configurazione del canale di recapito. Il sistema operativo stabilisce le connessioni al server SMTP utilizzando l'account del servizio.
Esempi
Gli esempi riportati di seguito illustrano come definire i canali di recapito SMTP nei file di configurazione dell'istanza (ICF).
Server SMTP
L'esempio riportato di seguito illustra come definire un canale di recapito per il protocollo di recapito SMTP predefinito. Poiché il protocollo di recapito SMTP è predefinito, non è necessaria la presenza di un valore corrispondente nell'elemento Protocols del file 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>
Utilizzo di uno smart host per inoltrare i messaggi
L'esempio riportato di seguito illustra come utilizzare il servizio SMTP locale di IIS con l'opzione smart host per inoltrare i messaggi. Configurare innanzitutto il servizio locale SMTP di IIS per l'inoltro dei messaggi, quindi il canale di recapito SMTP come indicato di seguito.
<DeliveryChannel>
<DeliveryChannelName>EmailChannel</DeliveryChannelName>
<ProtocolName>SMTP</ProtocolName>
</DeliveryChannel>
Per ulteriori informazioni sulla configurazione del servizio SMTP di IIS, vedere Utilizzo di SMTP per i messaggi in uscita in Microsoft MSDN Library.
Vedere anche
Concetti
Protocollo di recapito SMTP
Definizione dei canali di recapito
Altre risorse
Instance Configuration File Templates
Configurazione delle istanze di Notification Services