How to: Test Incoming Enable Libraries in SharePoint

joostFor a project I am currently involved with, we had to create email enabled libraries within SharePoint. At first sight this wasn’t such a problem and we’ve created an installation manual in order to configure all parts related to the Incoming mails. The part of installing and configuring all parts is heavily discussed all over the Internet and the document we’ve created was mainly based on the Blog written by Harmeet Walia. However due to some technical limitations we were not able to test the entire mail flow to date. However we really would want to test the pickup of the messages from the mail server and wanted to see them added to the configured library.

The only option I thought of was with the Command Prompt. However out of the box this isn’t possible, on the other side the good news was that sending emails using command prompt can be done using a Telnet session. The Telnet client can be installed from the Windows Server 2008 R2 Server Manager.

When everything is in place, it is possible to send the email to the SMTP service. In order to do so, first start Command Prompt as an Administrator.

Next execute the following command:

telnet {Server FQDN} 25

In the above mentioned command line first the program Telnet is used. Second the server name to which the connection needs to be set-up is defined, this needs to be the FQDN of the server. And the last part (here 25) is the port number. For mail client’s in most cases port 25 is being used.

When the Enter button is hit, a connection to the server is made. We see a new screen within the Command Prompt and we can start defining the email. First we have to configure several parts. In order to do this, execute the following command lines.

helo {server FQDN}
mail from:{your email address}
rcpt to:{email address of email enabled library}

Within the first line we say hello to the SMTP server (the helo as spelled above is the correct spelling format!). Don’t ask me why this has to be done with this spelling, but it has to be done anyway. Second you have to add a valid email address from which the mail is being send, and next to recipient of the email needs to be configured, which is in our case the email enabled library. Finish this block with data. When the Enter button is being hit, the message can be configured. For configuring the e-mail, use the following example:

Subject: test email

this is a test e-mail
Hello World
sent from Command Prompt

The From and Subject address are being displayed in you message. This can be any valid value. After hitting Enter twice it is possible to configure the body of the email. in this case we have defined three lines (but can be more or less). When the entire email is configured, a dot (.) needs to be entered in the Command Prompt. By entering a dot it is declared that the message is done and can be send. In this case the message is sent and queued on your SMTP server.