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.
| Alias | Cmdlet |
|---|---|
| mon-add | New-MonitoringInstance |
| mon-delete | Remove-MonitoringInstance |
| mon-instances | Get-MonitoringInstances |
| mon-upgrade | Invoke-MonitoringInstanceUpgrade |
| sc-help | Get-ServiceControlMgmtCommands |
| sc-transportsinfo | Get-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.