Get-CMDiscoveryMethod

Gets a discovery method for Configuration Manager.

Syntax

Get-CMDiscoveryMethod
   [-Name <DiscoveryType>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

The Get-CMDiscoveryMethod cmdlet gets a discovery method for Configuration Manager. Discovery identifies computer and user resources that Configuration Manager can manage. If it discovers a resource, Configuration Manager creates a record in the Configuration Manager database for the resource and its associated information. You can then use the discovery information to help you to install the Configuration Manager client and create custom queries and collections to logically group resources for related management tasks.

For more information about discovery in Configuration Manager, see About Configuration Manager Discovery.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Get a user discovery method

PS XYZ:\> Get-CMDiscoveryMethod -Name "ActiveDirectoryUserDiscovery"

This command gets a Configuration Manager method that discovers users in the installation.

Parameters

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the type of discovery method that the cmdlet gets. The acceptable values for this parameter are:

  • ActiveDirectoryForestDiscovery: Discovers security groups, including local, global, and universal groups from specified locations in Active Directory Domain Services.
  • ActiveDirectoryGroupDiscovery: Discovers additional information, including the OU and group membership of the computer, about previously discovered computers from specified locations in Active Directory Domain Services.
  • ActiveDirectorySystemDiscovery: Discovers computers from specified locations in Active Directory Domain Services.
  • ActiveDirectoryUserDiscovery: Discovers users from specified locations in Active Directory Domain Services.
  • HeartbeatDiscovery: Updates discovery records for Configuration Manager clients in the Configuration Manager database without discovering new resources.
  • NetworkForestDiscovery: Searches the network infrastructure for network devices (such as printers, routers, and bridges) that have an IP address.
Type:DiscoveryType
Accepted values:ActiveDirectoryForestDiscovery, ActiveDirectoryGroupDiscovery, ActiveDirectorySystemDiscovery, ActiveDirectoryUserDiscovery, NetworkDiscovery, HeartbeatDiscovery
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

Specifies a site code.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

IResultObject[]

IResultObject

IResultObject[]

IResultObject