Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
Set-CMDiscoveryMethod
- Module:
- ConfigurationManager Module
Changes configuration settings of a discovery method.
Syntax
SearchByActiveDirectoryForestDiscovery (Default)
Set-CMDiscoveryMethod
[-ActiveDirectoryForestDiscovery]
[-EnableActiveDirectorySiteBoundaryCreation <Boolean>]
[-Enabled <Boolean>]
[-EnableSubnetBoundaryCreation <Boolean>]
[-PassThru]
[-PollingSchedule <IResultObject>]
[-SiteCode <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByActiveDirectorySystemDiscovery
Set-CMDiscoveryMethod
[-ActiveDirectoryContainer <String[]>]
[-ActiveDirectorySystemDiscovery]
[-AddActiveDirectoryContainer <String[]>]
[-AddAdditionalAttribute <String[]>]
[-ClearActiveDirectoryContainer]
[-DeltaDiscoveryMins <Int32>]
[-Enabled <Boolean>]
[-EnableDeltaDiscovery <Boolean>]
[-EnableFilteringExpiredLogon <Boolean>]
[-EnableFilteringExpiredPassword <Boolean>]
[-EnableIncludeGroup <Boolean>]
[-EnableRecursive <Boolean>]
[-IncludeGroup]
[-PassThru]
[-PollingSchedule <IResultObject>]
[-Recursive]
[-RemoveActiveDirectoryContainer <String[]>]
[-RemoveAdditionalAttribute <String[]>]
[-SiteCode <String>]
[-TimeSinceLastLogonDays <Int32>]
[-TimeSinceLastPasswordUpdateDays <Int32>]
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByActiveDirectoryUserDiscovery
Set-CMDiscoveryMethod
[-ActiveDirectoryContainer <String[]>]
[-ActiveDirectoryUserDiscovery]
[-AddActiveDirectoryContainer <String[]>]
[-AddAdditionalAttribute <String[]>]
[-ClearActiveDirectoryContainer]
[-DeltaDiscoveryMins <Int32>]
[-Enabled <Boolean>]
[-EnableDeltaDiscovery <Boolean>]
[-EnableIncludeGroup <Boolean>]
[-EnableRecursive <Boolean>]
[-IncludeGroup]
[-PassThru]
[-PollingSchedule <IResultObject>]
[-Recursive]
[-RemoveActiveDirectoryContainer <String[]>]
[-RemoveAdditionalAttribute <String[]>]
[-SiteCode <String>]
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByActiveDirectoryGroupDiscovery
Set-CMDiscoveryMethod
[-ActiveDirectoryGroupDiscovery]
[-AddGroupDiscoveryScope <ADGroupDiscoveryScope[]>]
[-ClearActiveDirectoryContainer]
[-DeltaDiscoveryMins <Int32>]
[-DiscoverDistributionGroupMembership <Boolean>]
[-Enabled <Boolean>]
[-EnableDeltaDiscovery <Boolean>]
[-EnableFilteringExpiredLogon <Boolean>]
[-EnableFilteringExpiredPassword <Boolean>]
[-PassThru]
[-PollingSchedule <IResultObject>]
[-RemoveGroupDiscoveryScope <String[]>]
[-SiteCode <String>]
[-TimeSinceLastLogonDays <Int32>]
[-TimeSinceLastPasswordUpdateDays <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByNetworkDiscovery
Set-CMDiscoveryMethod
[-Enabled <Boolean>]
[-NetworkDiscovery]
[-NetworkDiscoveryType <NetworkDiscoveryType>]
[-PassThru]
[-SiteCode <String>]
[-SlowNetworkSpeed <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByHeartbeat
Set-CMDiscoveryMethod
[-Enabled <Boolean>]
[-Heartbeat]
[-PassThru]
[-PollingSchedule <IResultObject>]
[-SiteCode <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Set-CMDiscoveryMethod cmdlet changes configuration settings of a discovery method. Discovery identifies computer and user resources that Configuration Manager can manage. When Configuration Manager 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.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Examples
Example 1: Modify network discovery
PS XYZ:\> Set-CMDiscoveryMethod -NetworkDiscovery -SiteCode "CM4" -Enabled $True -NetworkDiscoveryType ToplogyAndClient -SlowNetworkSpeed $True
This command modifies network discovery for the site that has the site code CM4. The command specifies topology and client network discovery and the slow network speed option. The command also enables discovery.
Example 2: Modify Active Directory system discovery
PS XYZ:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10
PS XYZ:\> Set-CMDiscoveryMethod -ActiveDirectorySystemDiscovery -SiteCode "CM4" -AddAdditionalAttribute "331", "431", "134" -DeltaDiscoveryIntervalMinutes 8 -Enabled $True -EnableDeltaDiscovery $True -EnableFilteringExpiredLogon $True -PollingSchedule $Schedule -RemoveAdditionalAttribute "123","cn" -TimeSinceLastLogonDays 80
The first command creates a schedule object by using the New-CMSchedule cmdlet and stores it in the $Schedule variable.
The second command enables the computer discovery for the site that has the site code CM4. The command specifies the schedule object stored in the $Schedule variable as the polling schedule and enables delta discovery to find new and modified computers since the last discovery. The command specifies that delta discovery takes place every 8 minutes.
The second command also limits the computers found to those that a user has logged onto in the last 80 days. Also, the command adds and removes specified attributes from the attributes used to limit computers.
Example 3: Modify forest discovery
PS XYZ:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10
PS XYZ:\> Set-CMDiscoveryMethod -ActiveDirectoryForestDiscovery -SiteCode "CM4" -EnableActiveDirectorySiteBoundaryCreation $True -Enabled $True -EnableSubnetBoundaryCreation $True -PollingSchedule $Schedule
The first command creates a schedule object by using the New-CMSchedule cmdlet, and then stores it in the $Schedule variable.
The second command enables this discovery site that has the site code CM4. The command specifies the schedule object stored in the $Schedule variable as the polling interval and enables Active Directory boundary creation and subnet boundary creation.
Example 4: Enable heartbeat discovery
PS XYZ:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10
PS XYZ:\> Set-CMDiscoveryMethod -Heartbeat -SiteCode "CM4" -Enabled $True -PollingSchedule $Schedule
The first command creates a schedule object by using the New-CMSchedule cmdlet and stores it in the $Schedule variable.
The second command enables heartbeat discovery and specifies the object stored in the $Schedule variable as the polling schedule for the site that has the site code CM4.
Parameters
-ActiveDirectoryContainer
Specifies an array of names of Active Directory containers.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ActiveDirectoryForestDiscovery
Indicates that the discovery method discovers security groups, including local, global, and universal groups from specified locations in Active Directory Domain Services (AD DS).
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ActiveDirectoryGroupDiscovery
Indicates that the discovery method discovers additional information, including the computer organizational unit (OU) and group membership, about previously discovered computers from specified locations in AD DS.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ActiveDirectorySystemDiscovery
Indicates that the discovery method discovers computers from specified locations in AD DS.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ActiveDirectoryUserDiscovery
Indicates that the discovery method discovers users from specified locations in AD DS.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AddActiveDirectoryContainer
The Set-CMDiscoveryMethod cmdlet changes configuration settings of a discovery method. Discovery identifies computer and user resources that Configuration Manager can manage. When Configuration Manager 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.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | AddActiveDirectoryContainers |
Parameter sets
-AddAdditionalAttribute
Specifies an array of Active Directory object attributes. The cmdlet adds these attributes to the list of attributes that Configuration Manager discovers.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AddGroupDiscoveryScope
The Set-CMDiscoveryMethod cmdlet changes configuration settings of a discovery method. Discovery identifies computer and user resources that Configuration Manager can manage. When Configuration Manager 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.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Parameter properties
| Type: | ADGroupDiscoveryScope[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ClearActiveDirectoryContainer
The Set-CMDiscoveryMethod cmdlet changes configuration settings of a discovery method. Discovery identifies computer and user resources that Configuration Manager can manage. When Configuration Manager 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.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
-DeltaDiscoveryMins
The Set-CMDiscoveryMethod cmdlet changes configuration settings of a discovery method. Discovery identifies computer and user resources that Configuration Manager can manage. When Configuration Manager 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.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | DeltaDiscoveryIntervalMinutes, DeltaDiscoveryIntervalMins |
Parameter sets
-DisableWildcardHandling
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-DiscoverDistributionGroupMembership
The Set-CMDiscoveryMethod cmdlet changes configuration settings of a discovery method. Discovery identifies computer and user resources that Configuration Manager can manage. When Configuration Manager 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.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | DiscoverDistributionGroupsMembership |
Parameter sets
-EnableActiveDirectorySiteBoundaryCreation
Indicates whether Configuration Manager creates Active Directory boundaries from AD DS discovery information.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Enabled
Indicates whether to enable the Configuration Manager discovery. If you specify a value of $False, Configuration Manager does not discover resources by using this discovery.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableDeltaDiscovery
Indicates whether Configuration Manager discovers resources created or modified in AD DS since the last discovery cycle. If you specify a value of $True for this parameter, specify a value for the DeltaDiscoveryIntervalMinutes parameter.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableFilteringExpiredLogon
Indicates whether Configuration Manager discovers only computers that have logged onto a domain within a specified number of days. Specify the number of days by using the TimeSinceLastLogonDays parameter.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableFilteringExpiredPassword
Indicates whether Configuration Manager discovers only computers that have updated their computer account password within a specified number of days. Specify the number of days by using the TimeSinceLastPasswordUpdateDays parameter.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableIncludeGroup
{{ Fill EnableIncludeGroup Description }}
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | EnableIncludeGroups |
Parameter sets
-EnableRecursive
{{ Fill EnableRecursive Description }}
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableSubnetBoundaryCreation
Indicates whether Configuration Manager creates IP address range boundaries from AD DS discovery information.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ForceWildcardHandling
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Heartbeat
Indicates that the discovery method updates discovery records for Configuration Manager clients in the Configuration Manager database without discovering new resources.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-IncludeGroup
The Set-CMDiscoveryMethod cmdlet changes configuration settings of a discovery method. Discovery identifies computer and user resources that Configuration Manager can manage. When Configuration Manager 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.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | IncludeGroups |
Parameter sets
-NetworkDiscovery
Indicates that the discovery method searches the network infrastructure for network devices, such as printers, routers, and bridges, that have IP addresses.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NetworkDiscoveryType
Specifies the network discovery type. If you specify the NetworkDiscovery parameter, specify one of the following types:
- ToplogyAndClient. The discovery finds the topology of your network and potential client devices.
- ToplogyClientAndClientOperatingSystem. The discovery finds the topology of your network. The discovery finds potential client devices and their operating systems and versions.
- Topology. The discovery finds the topology of your network by discovering IP subnets and routers.
Parameter properties
| Type: | NetworkDiscoveryType |
| Default value: | None |
| Accepted values: | Topology, TopologyAndClient, ToplogyAndClient, TopologyClientAndClientOperatingSystem, ToplogyClientAndClientOperatingSystem |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PassThru
Add this parameter to return an object that represents the item with which you're working. By default, this cmdlet may not generate any output.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PollingSchedule
Specifies a schedule object. To obtain a schedule object, use the New-CMSchedule cmdlet. The polling schedule determines how often Configuration Manager attempts to discover groups, systems, or user data.
Parameter properties
| Type: | IResultObject |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Recursive
The Set-CMDiscoveryMethod cmdlet changes configuration settings of a discovery method. Discovery identifies computer and user resources that Configuration Manager can manage. When Configuration Manager 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.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-RemoveActiveDirectoryContainer
The Set-CMDiscoveryMethod cmdlet changes configuration settings of a discovery method. Discovery identifies computer and user resources that Configuration Manager can manage. When Configuration Manager 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.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | RemoveActiveDirectoryContainers |
Parameter sets
-RemoveAdditionalAttribute
Specifies an array of Active Directory object attributes. The cmdlet removes these attributes from the list of attributes that Configuration Manager discovers.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-RemoveGroupDiscoveryScope
The Set-CMDiscoveryMethod cmdlet changes configuration settings of a discovery method. Discovery identifies computer and user resources that Configuration Manager can manage. When Configuration Manager 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.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SiteCode
Specifies the site code for a Configuration Manager site.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SlowNetworkSpeed
Indicates whether Configuration Manager makes adjustments to its discovery settings for networks that have low bandwidth.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-TimeSinceLastLogonDays
Specifies the number of days since the last logon when the EnableFilteringExpiredLogon parameter had a value of $True.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-TimeSinceLastPasswordUpdateDays
Specifies the number of days since that last password updated when the EnableFilteringExpiredPassword parameter had a value of $True.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-UserName
{{ Fill UserName Description }}
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | DiscoveryAccountUserName |
Parameter sets
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet doesn't run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
None
Related Links
Feedback
Was this page helpful?