Export (0) Print
Expand All
Expand Minimize

Disable-SCOMDiscovery

Updated: January 26, 2014

Applies To: System Center 2012 R2 Operations Manager

Disable-SCOMDiscovery

Disables Operations Manager discoveries.

Syntax

Parameter Set: Empty
Disable-SCOMDiscovery [-ManagementPack] <ManagementPack> [-Discovery] <ManagementPackDiscovery[]> [[-Enforce]] [[-PassThru]] [ <CommonParameters>]

Parameter Set: FromGroup
Disable-SCOMDiscovery [[-Group] <MonitoringObject[]> ] [-ManagementPack] <ManagementPack> [-Discovery] <ManagementPackDiscovery[]> [[-Enforce]] [[-PassThru]] [ <CommonParameters>]

Parameter Set: FromInstance
Disable-SCOMDiscovery [[-Instance] <MonitoringObject[]> ] [-ManagementPack] <ManagementPack> [-Discovery] <ManagementPackDiscovery[]> [[-Enforce]] [[-PassThru]] [ <CommonParameters>]

Parameter Set: FromManagementPackClass
Disable-SCOMDiscovery [-Class] <ManagementPackClass[]> [-ManagementPack] <ManagementPack> [-Discovery] <ManagementPackDiscovery[]> [[-Enforce]] [[-PassThru]] [ <CommonParameters>]




Detailed Description

The Disable-SCOMDiscovery cmdlet disables System Center 2012 – Operations Manager discoveries. The cmdlet creates and saves overrides for specified discoveries that disable those discoveries.

Specify groups, instances, or classes, along with the discoveries to disable. The cmdlet saves overrides to a specified unsealed management pack.

Parameters

-Class<ManagementPackClass[]>

Specifies an array of management pack class objects. To obtain a class object, use the Get-SCOMClass cmdlet. The cmdlet disables discoveries for these classes.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Discovery<ManagementPackDiscovery[]>

Specifies an array of ManagementPackDiscovery objects. To obtain a ManagementPackDiscovery object, use the Get-SCOMDiscovery cmdlet.


Aliases

none

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Enforce

Indicates that the cmdlet sets the Enforce property to $True on the override.


Aliases

none

Required?

false

Position?

4

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Group<MonitoringObject[]>

Specifies an array of monitoring objects that represent groups. To obtain a group, use the Get-SCOMGroup cmdlet. The cmdlet disables discoveries for these groups.


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Instance<MonitoringObject[]>

Specifies an array of monitoring objects that represent instances. To obtain instances, use the Get-SCOMClassInstance cmdlet. The cmdlet disables discoveries for these instances.


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. To obtain a management pack object, use the Get-SCOMManagementPack cmdlet. The cmdlet saves overrides into the specified management pack.

If the discovery is in an unsealed management pack, you must save the override into the same management pack.


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-PassThru

Indicates that the cmdlet creates or modifies an object that a command can use in the pipeline. 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.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

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

Examples

Example 1: Disable discoveries for a class

This example disables discoveries for a specified class. The Disable-SCOMDiscovery cmdlet saves an override in a specified management pack.

The first command uses the Get-SCOMManagementPack cmdlet to get management pack objects that have the specified display name, and passes them to the Where-Object cmdlet by using the pipeline operator. That cmdlet drops any sealed management packs. For more information, type Get-Help Where-Object. The command stores all unsealed management packs in the $MP variable.

The second command uses the Get-SCOMClass cmdlet to get classes that have the specified display name, and then stores them in the $Class variable.

The third command uses the Get-SCOMDiscovery cmdlet to get discovery objects that have display names that contain the string rule, and then stores them in the $Discovery variable.

The fourth command disables the discoveries represented by the objects stored in the $Discovery variable. The command specifies the class object stored in the $Class variable. The cmdlet saves the override in the management pack represented by the object in the $MP variable. The command uses the Enforce parameter; therefore the cmdlet sets the Enforce property to $True.


PS C:\> $MP = Get-SCOMManagementPack -displayname "My SQL MP Customization" | Where-Object {$_.Sealed -eq $False}
PS C:\> $Class = Get-SCOMClass -DisplayName "SQL DB Engine"
PS C:\> $Discovery = Get-SCOMDiscovery -DisplayName *rule*
PS C:\> Disable-SCOMDiscovery -Class $Class -Discovery $Discovery -ManagementPack $MP

Related topics


Get-SCOMClass

Get-SCOMClassInstance

Get-SCOMDiscovery

Get-SCOMManagementPack

Enable-SCOMDiscovery

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft