How to configure an Internet Information Services SMTP virtual server to archive or to remove messages in an Exchange Server 2003 test environment

• Install the SMTP Service
• Configure the SMTP virtual server to accept e-mail messages for one or more domains
• Create and then register an event sink to delete the messages from the SMTP virtual server

Back to the top

Back to the top

Configure the SMTP server in Internet Information Services

1. Install the SMTP Service by using the Add or Remove Programs tool in Control Panel. To do this, follow these steps:
   1. Click Start, point to All Programs, and then click Control Panel.
   2. Click Add or Remove Programs.
   3. Click Add/Remove Windows Components, click Application Server, click Details, click Internet Information Services (IIS), click Details, click to select the SMTP Service check box, and then click OK two times.
   4. Click Next, insert your Windows CD if you are prompted, and then click Finish when the Windows Components Wizard has completed successfully.
2. Start the Internet Information Services (IIS) Manager tool.
3. Expand ServerName (local computer), expand Default SMTP Virtual Server, and then click Domains.
4. Right-click Domains, point to New, and then click Domain.
5. Click Alias, click Next, type the fully qualified domain name (FQDN) of your test domain in the Name box, and then click Finish.
6. Repeat steps 4 and 5 to add each of your test domains. If you do not add a domain, the SMTP virtual server refuses to accept messages for that domain. For additional information about how to create or to remove SMTP domains, see the "REFERENCES" section of this article.

Back to the top

Configure a message removal event sink

Example

1. Copy and then paste the following VBScript code to a file that is named DeleteMsg.vbs:

   <SCRIPT LANGUAGE="VBScript">
   
   Sub IEventIsCacheable_IsCacheable
   
     ' just returns S_OK
   
   End Sub
   
    
   
   Sub ISMTPOnArrival_OnArrival(ByVal iMsg, EventStatus )
   
     On Error Resume Next
   
    
   
     ' CDO constants
   
     Const cdoSkipRemainingSinks = 1
   
     Const cdoStatusAbortDelivery = 2
   
    
   
     Set Flds = iMsg.EnvelopeFields
   
     Flds("http://schemas.microsoft.com/cdo/smtpenvelope/messagestatus") = cdoStatusAbortDelivery
   
     Flds.Update
   
     EventStatus = cdoSkipRemainingSinks
   
     iMsg.DataSource.Save
   
   End Sub
   
   </SCRIPT>
   
   

2. On the computer where you configured the IIS SMTP server, save the DeleteMsg.vbs file in the following folder:
   %SYSTEMDRIVE%\InetPub\AdminScripts
   Note You do not have to store this file in the AdminScripts folder. However, you may locate your script files more easily if they are stored in this folder.
3. Obtain the Smtpreg.vbs Event Management Script, and then store it in the same folder where you saved the DeleteMsg.vbs file. You can use the Smtpreg.vbs script to add, remove, and enumerate event sinks on the IIS SMTP virtual server. To obtain this script, follow these steps:
   1. Visit the following Microsoft Developer Network (MSDN) Web site:
      http://msdn2.microsoft.com/en-us/library/ms528023.aspx (http://msdn2.microsoft.com/en-us/library/ms528023.aspx)
   2. Copy the code that appears on this Web site to a file that is named Smtpreg.vbs.
4. Register the event sink. For additional information about how to register or un-register event sinks, see the "REFERENCES" section of this article. To register the event sink, follow these steps:
   1. Start a command prompt, and then change to the %SYSTEMDRIVE%\InetPub\AdminScripts folder.
   2. Type the following command, and then press ENTER:
      cscript smtpreg.vbs /add virtualServerInstance OnArrival DeleteMsg CDO.SS_SMTPOnArrivalSink "mail from=*"
      Note Replace virtualServerInstance with the SMTP virtual server instance number. For example, replace virtualServerInstance with 1.
   3. Type the following command, and then press ENTER:
      cscript smtpreg.vbs /setprop virtualServerInstance OnArrival DeleteMsg Sink ScriptName "drive:\Inetpub\AdminScripts\DeleteMsg.vbs"
      Note Replace drive with the letter of the drive where the DeleteMsg.vbs file is located.
   After you register this event sink, no messages are placed in the Drop folder. Instead all messages are deleted at the OnArrival event.
   
   To un-register the event sink, follow these steps:
   1. Start a command prompt, and then change to the %SYSTEMDRIVE%\InetPub\AdminScripts folder.
   2. Type the following command, and then press ENTER:
      cscript smtpreg.vbs /remove virtualServerInstance OnArrival DeleteMsg
      Note Replace virtualServerInstance with the SMTP virtual server instance number. For example, replace virtualServerInstance with 1.

Back to the top

Configure performance counters

Back to the top

Configure the event sink to remove messages from any domain

1. Follow the instructions in the "Configure a message removal event sink" section of this article to configure the DeleteMsg.vbs event sink.
2. Start the Internet Information Services (IIS) Manager tool.
3. Expand ServerName (local computer), right-click the SMTP virtual server where you configured the event sink, and then click Properties.
4. Click the Delivery tab, and then click Advanced.
5. In the Smart host box, type a bogus computer name. This action is to help make sure that e-mail messages will not be routed to their destination if the event sink is removed.
6. Click OK, and then click the Access tab.
7. Click Relay, click All except the list below, and then click OK two times.

Back to the top