Get-ClusterVMMonitoredItem

Get-ClusterVMMonitoredItem

Gets the list of services and events currently being monitored in the virtual machine.

Syntax

Parameter Set: InputObject
Get-ClusterVMMonitoredItem [[-VirtualMachine] <String> ] [-Cluster <String> ] [-InputObject <PSObject> ] [ <CommonParameters>]

Detailed Description

The Get-ClusterVMMonitoredItem cmdlet gets the list of services and events currently being monitored in the virtual machine. If one of those services fails or one of the events occurs, then the system responds by taking an action based on the failover configuration for the virtual machine resource. For example, the configuration might specify that the virtual machine be restarted.

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

Local Cluster

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InputObject<PSObject>

Specifies the cluster on which to run the cmdlet or the clustered virtual machine for which to retrieve the clustered virtual machine monitored item object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-VirtualMachine<String>

Specifies the name of the clustered virtual machine on which to perform monitoring. When this parameter is specified, the 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

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.FailoverClusters.PowerShell.ClusterVMMonitoredItem

Examples

Example 1

This example returns the services and events being monitored in the virtual machine named vm1 on the cluster named Cluster1.

PS C:\> Get-Cluster –Name Cluster1 | Get-ClusterVMMonitoredItem –VirtualMachine vm1

Add-ClusterVMMonitoredItem

Remove-ClusterVMMonitoredItem

Reset-ClusterVMMonitoredState