Managing Monitoring instances via PowerShell

For general information about ServiceControl Powershell, including troubleshooting and licensing guidance, see Managing ServiceControl via PowerShell.

Monitoring instance Cmdlets and Aliases

The following cmdlets and aliases are provided by the ServiceControl Management PowerShell module for managing Monitoring instances.

AliasCmdlet
mon-addNew-MonitoringInstance
mon-deleteRemove-MonitoringInstance
mon-instancesGet-MonitoringInstances
mon-upgradeInvoke-MonitoringInstanceUpgrade
sc-helpGet-ServiceControlMgmtCommands
sc-transportsinfoGet-ServiceControlTransportTypes

Help

All of the cmdlets have local help which can be accessed via the standard PowerShell help command

Get-Help Get-MonitoringInstances

Adding an instance

New-MonitoringInstance -Name Test.Monitoring -InstallPath C:\ServiceControlMonitor\Bin -LogPath C:\ServiceMonitor\Logs -Port 33335 -Transport MSMQ

There are additional parameters available to set additional configuration options such as hostname, transport connection string, and error queue.

Removing an instance

Remove the instance that was created in the Add sample and delete the logs:

Remove-MonitoringInstance -Name Test.Monitoring -RemoveLogs

To List existing instances of the ServiceControl Monitoring service use Get-MonitoringInstances.

Upgrading an instance

The following command will list the ServiceControl Monitoring instances current installed and their version number.

Get-MonitoringInstances | Select Name, Version

To upgrade and instance to the latest version of the binaries run.

Invoke-MonitoringInstanceUpgrade -Name <Instance To upgrade>

The upgrade will stop the service if it is running. Additional parameters for Invoke-MonitoringInstanceUpgrade may be required. The configuration file of the existing version is examined prior to determine if all the required settings are present. If a configuration setting is missing then the cmdlet will throw an error indicating the required additional parameter.


Last modified