Get-MonitoringObject
Get-MonitoringObject
Gets monitoring objects.
Syntax
Parameter Set: FromMonitoringObjectProviderPath
Get-MonitoringObject [[-Path] <String[]> ] [ <CommonParameters>]
Parameter Set: FromCriteria
Get-MonitoringObject [-MonitoringClass] <MonitoringClass> [[-Criteria] <String> ] [[-Path] <String[]> ] [ <CommonParameters>]
Parameter Set: FromId
Get-MonitoringObject [-Id] <Guid> [[-Path] <String[]> ] [ <CommonParameters>]
Detailed Description
Gets all monitoring objects for the specified Path or with the specified identifier. Can also retrieve all monitoring objects of a specified monitoring class. Optional criteria, expressed in the System Center Operations Manager (SCOM), criteria expression syntax, can be specified to further filter the monitoring objects retrieved.
Parameters
-Criteria<String>
Specifies criteria using syntax designed for use with System Center Operations Manager. Only rules that meet the specified criteria will be retrieved. To learn about the syntax, consult the SDK topic, "Criteria Expression Syntax", in the System Center Operations Manager 2007 SDK. You can find the SDK by search Microsoft Developer Network (MSDN) online at https://msdn.microsoft.com.
Aliases |
none |
Required? |
false |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Id<Guid>
Specifies the GUID of the monitoring object to retrieve.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-MonitoringClass<MonitoringClass>
Specifies a monitoring class. If used, the cmdlet will return monitoring objects of this specified class.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Path<String[]>
Specifies the path or paths of monitoring objects to retrieve.
Aliases |
none |
Required? |
false |
Position? |
4 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters
Notes
- For more information, type "Get-Help Get-MonitoringObject -detailed". For technical information, type "Get-Help Get-MonitoringObject -full".
When specifying multiple values for a parameter, use commas to separate the values. For example, "<parameter-name> <value1>, <value2>".
Examples
-------------- EXAMPLE 1 --------------
This command gets all monitoring objects associated with the current path.
C:\PS>get-monitoringobject
-------------- EXAMPLE 2 --------------
This command get the monitoring object with the specified GUID.
C:\PS>get-monitoringobject -id <GUID>
-------------- EXAMPLE 3 --------------
This command first uses Get-MonitoringClass to retrieve all monitoring classes named Microsoft.Windows.Computer. It then pipelines the results to Get-MonitoringObject to return all objects of that class.
C:\PS>get-monitoringclass -name "Microsoft.Windows.Computer" |
get-monitoringobject