Disable-SCOMMonitor
Updated: September 10, 2012
Applies To: System Center 2012 - Operations Manager, System Center 2012 SP1 - Operations Manager
Disable-SCOMMonitor
Syntax
Parameter Set: Empty Disable-SCOMMonitor [-ManagementPack] <ManagementPack> [-Monitor] <ManagementPackMonitor[]> [[-Enforce]] [[-PassThru]] [ <CommonParameters>] Parameter Set: FromGroup Disable-SCOMMonitor [[-Group] <MonitoringObject[]> ] [-ManagementPack] <ManagementPack> [-Monitor] <ManagementPackMonitor[]> [[-Enforce]] [[-PassThru]] [ <CommonParameters>] Parameter Set: FromInstance Disable-SCOMMonitor [[-Instance] <MonitoringObject[]> ] [-ManagementPack] <ManagementPack> [-Monitor] <ManagementPackMonitor[]> [[-Enforce]] [[-PassThru]] [ <CommonParameters>] Parameter Set: FromManagementPackClass Disable-SCOMMonitor [-Class] <ManagementPackClass[]> [-ManagementPack] <ManagementPack> [-Monitor] <ManagementPackMonitor[]> [[-Enforce]] [[-PassThru]] [ <CommonParameters>]
Detailed Description
The Disable-SCOMMonitor cmdlet disables monitors by creating and saving overrides for the specified monitors.
Parameters
-Class<ManagementPackClass[]>
Specifies one or more class objects for which the monitors will be disabled. Enter a variable that represents the classes, or type a command that gets the classes. For information about how to get a class object, type Get-Help Get-SCOMClass.
|
Aliases |
none |
|
Required? |
true |
|
Position? |
1 |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByValue) |
|
Accept Wildcard Characters? |
false |
-Enforce
Indicates that the enforce property will be set to True on the override that is created to disable the specified monitors.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
3 |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByValue) |
|
Accept Wildcard Characters? |
false |
-Group<MonitoringObject[]>
Specifies one or more group objects for which the monitors will be disabled. Enter a variable that represents the groups, or type a command that gets the groups.For information about how to get a group object, type Get-Help Get-SCOMGroup.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
1 |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByValue) |
|
Accept Wildcard Characters? |
false |
-Instance<MonitoringObject[]>
Specifies one or more class instance objects for which the monitors will be disabled. Enter a variable that represents the class instances, or type a command that gets the class instances. This parameter also accepts group objects.For information about how to get a class instance object, type Get-Help Get-SCOMClassInstance.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
1 |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByValue) |
|
Accept Wildcard Characters? |
false |
-ManagementPack<ManagementPack>
Specifies one or more management pack objects into which the disabling override will be saved. If the monitor is contained in an unsealed management pack, the overrides must be saved into the same management pack. Enter a variable that represents the management packs, or type a command that gets the management packs.For information about how to get a management pack object, type Get-Help Get-SCOMManagementPack.
|
Aliases |
none |
|
Required? |
true |
|
Position? |
1 |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByValue) |
|
Accept Wildcard Characters? |
false |
-Monitor<ManagementPackMonitor[]>
Specifies one or more monitor objects. Enter a variable that represents the monitors, or type a command that gets the monitors.
For information about how to get a monitor object, type Get-Help Get-SCOMMonitor.
|
Aliases |
none |
|
Required? |
true |
|
Position? |
2 |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByValue) |
|
Accept Wildcard Characters? |
false |
-PassThru
Returns an object representing the monitor. By default, this cmdlet does not generate any output.
|
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.
Examples
-------------------------- EXAMPLE 1 --------------------------
Description
-----------
The first three commands get a management pack object, a class object, and a monitor object, and then store the objects in the $MP, $Class, and $Monitor variables, respectively.
The fourth command disables the monitor stored in $Monitor for all instances of the class stored in $Class using Enforce property. The override is stored in the management pack stored in $MP.
PS C:\>$MP = Get-SCOMManagementPack -displayname "My SQL MP Customization" | where {$_.Sealed -eq $False}PS C:\>$Class = Get-SCOMClass -DisplayName "SQL DB Engine"PS C:\>$Monitor = Get-SCOMMonitor -DisplayName *memory*PS C:\>Disable-SCOMMonitor -Class $Class -ManagementPack $MP -Monitor $Monitor -Enforce
