This topic has not yet been rated - Rate this topic

Get-SCOMDiscovery

Updated: September 10, 2012

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

Get-SCOMDiscovery

Retrieves discovery information from Operations Manager.

Syntax

Parameter Set: __AllParameterSets
Get-SCOMDiscovery [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Parameter Set: FromDiscoveryDisplayName
Get-SCOMDiscovery [-DisplayName] <String[]> [ <CommonParameters>]

Parameter Set: FromDiscoveryId
Get-SCOMDiscovery [-Id] <Guid[]> [ <CommonParameters>]

Parameter Set: FromDiscoveryName
Get-SCOMDiscovery [-Name] <String[]> [ <CommonParameters>]

Parameter Set: FromManagementPack
Get-SCOMDiscovery [-ManagementPack] <ManagementPack[]> [ <CommonParameters>]

Parameter Set: FromManagementPackClass
Get-SCOMDiscovery [-Target] <ManagementPackClass[]> [ <CommonParameters>]

Detailed Description

The Get-SCOMDiscovery cmdlet retrieves discovery information from Operations Manager.

Parameters

-ComputerName<String[]>

Specifies a computer to establish a connection with. The computer must be running the System Center Data Access service. The default value is the computer for the current management group connection.

Valid formats include a NetBIOS name, an IP address, or a fully qualified domain name (FQDN). To specify the local computer, type the computer name, "localhost", or a dot (.).

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Credential<PSCredential>

Specifies a user account under which the management group connection will run. The account must have access to the server that is specified in the ComputerName parameter, if the server is specified. The default value is the current user.

You can enter a PSCredential object that is returned by the Get-Credential cmdlet.

Aliases	none
Required?	false
Position?	named
Default Value	Current user context
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DisplayName<String[]>

Specifies the display name of the discovery object to be retrieved.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	true

-Id<Guid[]>

Specifies the Id (guid) of the discovery object to be retrieved. This may be a Guid or a string that will be converted to a Guid.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-ManagementPack<ManagementPack[]>

Specifies one or more management packs containing the discovery objects to retrieve.

You can enter a ManagementPack object that is returned by the Get-SCOMManagementPack cmdlet.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-Name<String[]>

Specifies the name of a discovery object to retrieve.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	true

-SCSession<Connection[]>

Specifies a connection to a management server. The default value is the current management group connection.

You can enter a management group connection object that is returned by the Get-SCOMManagementGroupConnection cmdlet.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Target<ManagementPackClass[]>

Specifies the management pack that contains the classes that are targeted by the discovery.

Aliases	none
Required?	true
Position?	1
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.

Microsoft.EnterpriseManagement.Configuration.ManagementPack
You can pipe a management pack object to the ManagementPack parameter of the Get-SCOMDiscovery cmdlet.
System.String
You can pipe a discovery name to the Name parameter of the Get-SCOMDiscovery cmdlet.
System.Guid
You can pipe a Guid of a discovery object to the Id parameter of the Get-SCOMDiscovery cmdlet.
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
You can pipe a management pack to the Target parameter of the Get-SCOMDiscovery cmdlet.

Outputs

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

Microsoft.EnterpriseManagement.Configuration.ManagementPackDiscovery
This cmdlets generates a discovery object.

Examples

-------------------------- EXAMPLE 1 --------------------------

The command in this example retrieves the discoveries that are defined in Operations Manager.

PS C:\>Get-SCOMDiscovery

-------------------------- EXAMPLE 2 --------------------------

Gets the discovery that is named '*PopulateRootM*' and formats the output as a list.

PS C:\>Get-SCOMDiscovery -Name *PopulateRootM*|format-list

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)