Installing MSMQ Using MSMQADM.EXE

A version of this page is also available for

4/8/2010

Make sure your device has a unique name on the network before installing MSMQ.

To install MSMQ manually

Open the command prompt and do the following steps.
```
msmqadm register
msmqadm start
```

To install MSMQ in your application

Run MSMQADM as part of your own installation program.
Your installation program must verify that MSMQ installation exists on the computer by checking for the existence of the HKEY_LOCAL_MACHINE\Software\Microsoft\MSMQ key.

If the key exists, MSMQ is installed.
Run MSMQADM to configure MSMQ service for the second shell of MSMQADM.
```
msmqadm -f \temp\msmqadm.txt register
```
The command -f instructs MSMQADM to redirect output to the file whose name follows the switch. In this case it is \temp\msmqadm.txt.

If registration is successful, there is no output, which means the file is empty.

In case of an error, the file contains an error message in plain ASCII text.

You can also supply standard registry parameters to supply the GUID, the MSMQ store directory, the name of the out-FRS server, and other parameters.

Some registration parameters can only be changed using the following command.
```
msmqadm -f \temp\msmqadm.txt change ...
```
For information about the syntax of this command, see Using the MSMQAdm Utility.
When MSMQ is installed and configured, your installation program should start the MSMQ service using the following command.
```
msmqadm start
```
- or -

Your installation program can force the device to reboot so the MSMQ device driver can be loaded. MSMQ starts after rebooting.
Use the following command to stop the service.
```
msmqadm stop
```
Be careful when stopping the MSMQ service. Other applications might be using it, which causes unexpected results.

See Also