Remove-ClusterVMMonitoredItem
Remove-ClusterVMMonitoredItem
Removes monitoring of a service or event that is currently being monitored on a virtual machine.
Syntax
Parameter Set: InputObject
Remove-ClusterVMMonitoredItem [[-VirtualMachine] <String> ] [-Cluster <String> ] [-EventId <Int32> ] [-EventLog <String> ] [-EventSource <String> ] [-InputObject <PSObject> ] [-Service <StringCollection> ] [ <CommonParameters>]
Detailed Description
The Remove-ClusterVMMonitoredItem cmdlet removes monitoring of a service or event that is currently being monitored. After removal, if the service fails or the event occurs, the system will no longer take an action, such as restarting the virtual machine.
Parameters
-Cluster<String>
Specifies the name of the cluster on which to run this cmdlet. If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-EventId<Int32>
Specifies the event identifier (ID) of the Event Tracing for Windows (ETW) event to be removed from monitoring.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-EventLog<String>
Specifies the event log of the event to be removed from monitoring.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-EventSource<String>
Specifies the event source of the event to be removed from monitoring.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-InputObject<PSObject>
Specifies the cluster on which to run the cmdlet, the clustered virtual machine from which to remove monitoring, or the clustered virtual machine monitored item object to stop monitoring.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Service<StringCollection>
Specifies the name of the service to be removed from monitoring.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-VirtualMachine<String>
Specifies the name of the clustered virtual machine from which to remove monitoring. When this parameter is specified, this cmdlet must be run on one of the host cluster nodes, or else the Cluster parameter must also be specified.
Aliases |
none |
Required? |
false |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
- Microsoft.FailoverClusters.PowerShell.Cluster
- Microsoft.FailoverClusters.PowerShell.ClusterGroup
- Microsoft.FailoverClusters.PowerShell.ClusterResource
- Microsoft.FailoverClusters.PowerShell.ClusterVMMonitoredItem
Outputs
The output type is the type of the objects that the cmdlet emits.
- None
Examples
Example 1
This example removes all of the items being monitored on the virtual machine named VM1.
PS C:\> Get-ClusterVMMonitoredItem -VirtualMachine VM1 | Remove-ClusterVMMonitoredItem -VirtualMachine VM1
Example 2
This example removes monitoring on the print spooler service on the virtual machine named VM1.
PS C:\> Remove-ClusterVMMonitoredItem -VirtualMachine VM1 -Service spooler