Platform SDK: Exchange Server

Installing a Service Using SERVINST

SERVINST is used to install a service such as a mailbox agent or gateway. This allows the service to be controlled by the service control manager.

To install a mailbox agent service

  1. Create an object in the directory for the service using a utility such as GWINST. See GWINST: Installing a Mail-Gateway Object.
  2. Verify that the service has been installed by checking for its name in Services under the Control Panel.
  3. Use the PROFINST sample application if you want to create a profile for the service to use each time it starts. Such a profile allows you to examine the mailbox for a service. See PROFINST: Installing a MAPI Profile.
  4. If the mailbox agent or gateway is designed to use an extension DLL, create a directory and copy the extension DLL into the directory. Use the EXTNINST sample application to install the DLL. See EXTNINST: Installing an Administrator Extension.

After installing a service, you can control it with the Windows NT service control manager. Using SERVINST has no effect on objects in the directory.

Example

SERVINST /SITEDN=/o=Microsoft/ou=APPS-WGA 
 /OBJNAME=gw1 /OBJTYPE=GATEWAY 
 /SERVICE=gw1 /DISPLAY_NAME=samplgw 
 /DEPENDENCIES=msexchangesa%msexchangeds 
 /EXE=\\myserver\myshare\samplegw\samplegw.exe 
 /SERVER=server1 /ACCOUNT=mydomain\myaccount 
 /PASSWORD=mypassword