Expand Minimize
This topic has not yet been rated - Rate this topic

Disable-SCOMMonitor

Updated: September 10, 2012

Applies To: System Center 2012 - Operations Manager, System Center 2012 SP1 - Operations Manager

Disable-SCOMMonitor

Disables monitors by creating and saving overrides for the specified monitors.

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

Related topics


Get-SCOMClass

Get-SCOMClassInstance

Get-SCOMManagementPack

Enable-SCOMMonitor

Get-SCOMMonitor

 
Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.