< Back
Install-CMsmq
Post
NAME Install-CMsmq
SYNOPSIS
Installs Microsoft's Message Queueing system/feature.
SYNTAX
Install-CMsmq [-HttpSupport] [-ActiveDirectoryIntegration] [-Dtc] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Microsoft's MSMQ is *not* installed by default. It has to be turned on manually. This function will enable the
MSMQ feature. There are two sub-features: Active Directory integration and HTTP support. These can also be
enabled by setting the `ActiveDirectoryIntegration` and `HttpSupport` switches, respectively. If MSMQ will be
working with queues on other machines, you'll need to enable DTC (the Distributed Transaction Coordinator) by
passing the `DTC` switch.
This function uses Microsoft's feature management command line utilities: `ocsetup.exe` or
`servermanagercmd.exe`. **A word of warning**, however. In our experience, **these tools do not seem to work as
advertised**. They are very slow, and, at least with MSMQ, we have intermittent errors installing it on our
developer's Windows 7 computers. We strongly recommend you install MSMQ manually on a base VM or computer image
so that it's a standard part of your installation. If that isn't possible in your environment, good luck! let us
know how it goes.
If you know better ways of installing MSMQ or other Windows features, or can help us figure out why Microsoft's
command line installation tools don't work consistently, we would appreciate it.
PARAMETERS
-HttpSupport [<SwitchParameter>]
Enable HTTP Support
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-ActiveDirectoryIntegration [<SwitchParameter>]
Enable Active Directory Integrations
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Dtc [<SwitchParameter>]
Will MSMQ be participating in external, distributed transactions? I.e. will it be sending messages to queues
on other machines?
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Install-CMsmq
Installs MSMQ on this meachine. In our experience, this may or may not work. You'll want to check that the MSMQ
service exists and is running after this. Please help us make this better!
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Install-CMsmq -HttpSupport -ActiveDirectoryIntegration -Dtc
Installs MSMQ with the HTTP support and Active Directory sub-features. Enables and starts the Distributed
Transaction Coordinator.
RELATED LINKS
SYNOPSIS
Installs Microsoft's Message Queueing system/feature.
SYNTAX
Install-CMsmq [-HttpSupport] [-ActiveDirectoryIntegration] [-Dtc] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Microsoft's MSMQ is *not* installed by default. It has to be turned on manually. This function will enable the
MSMQ feature. There are two sub-features: Active Directory integration and HTTP support. These can also be
enabled by setting the `ActiveDirectoryIntegration` and `HttpSupport` switches, respectively. If MSMQ will be
working with queues on other machines, you'll need to enable DTC (the Distributed Transaction Coordinator) by
passing the `DTC` switch.
This function uses Microsoft's feature management command line utilities: `ocsetup.exe` or
`servermanagercmd.exe`. **A word of warning**, however. In our experience, **these tools do not seem to work as
advertised**. They are very slow, and, at least with MSMQ, we have intermittent errors installing it on our
developer's Windows 7 computers. We strongly recommend you install MSMQ manually on a base VM or computer image
so that it's a standard part of your installation. If that isn't possible in your environment, good luck! let us
know how it goes.
If you know better ways of installing MSMQ or other Windows features, or can help us figure out why Microsoft's
command line installation tools don't work consistently, we would appreciate it.
PARAMETERS
-HttpSupport [<SwitchParameter>]
Enable HTTP Support
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-ActiveDirectoryIntegration [<SwitchParameter>]
Enable Active Directory Integrations
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Dtc [<SwitchParameter>]
Will MSMQ be participating in external, distributed transactions? I.e. will it be sending messages to queues
on other machines?
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Install-CMsmq
Installs MSMQ on this meachine. In our experience, this may or may not work. You'll want to check that the MSMQ
service exists and is running after this. Please help us make this better!
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Install-CMsmq -HttpSupport -ActiveDirectoryIntegration -Dtc
Installs MSMQ with the HTTP support and Active Directory sub-features. Enables and starts the Distributed
Transaction Coordinator.
RELATED LINKS