Set-CMDiscoveryMethod

  • [アーティクル]

Set-CMDiscoveryMethod

Changes configuration settings of a discovery method.

構文

Parameter Set: SearchByActiveDirectoryForestDiscovery
Set-CMDiscoveryMethod -ActiveDirectoryForestDiscovery -SiteCode <String> [-EnableActiveDirectorySiteBoundaryCreation <Boolean> ] [-Enabled <Boolean> ] [-EnableSubnetBoundaryCreation <Boolean> ] [-PollingSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByActiveDirectoryGroupDiscovery
Set-CMDiscoveryMethod -ActiveDirectoryGroupDiscovery -SiteCode <String> [-DeltaDiscoveryIntervalMinutes <Int32> ] [-DiscoverDistributionGroupsMembership <Boolean> ] [-Enabled <Boolean> ] [-EnableDeltaDiscovery <Boolean> ] [-EnableFilteringExpiredLogon <Boolean> ] [-EnableFilteringExpiredPassword <Boolean> ] [-PollingSchedule <IResultObject> ] [-TimeSinceLastLogonDays <Int32> ] [-TimeSinceLastPasswordUpdateDays <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByActiveDirectorySystemDiscovery
Set-CMDiscoveryMethod -ActiveDirectorySystemDiscovery -SiteCode <String> [-ActiveDirectoryContainer <String[]> ] [-AddAdditionalAttribute <String[]> ] [-DeltaDiscoveryIntervalMinutes <Int32> ] [-Enabled <Boolean> ] [-EnableDeltaDiscovery <Boolean> ] [-EnableFilteringExpiredLogon <Boolean> ] [-EnableFilteringExpiredPassword <Boolean> ] [-PollingSchedule <IResultObject> ] [-RemoveAdditionalAttribute <String[]> ] [-TimeSinceLastLogonDays <Int32> ] [-TimeSinceLastPasswordUpdateDays <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByActiveDirectoryUserDiscovery
Set-CMDiscoveryMethod -ActiveDirectoryUserDiscovery -SiteCode <String> [-ActiveDirectoryContainer <String[]> ] [-AddAdditionalAttribute <String[]> ] [-DeltaDiscoveryIntervalMinutes <Int32> ] [-Enabled <Boolean> ] [-EnableDeltaDiscovery <Boolean> ] [-PollingSchedule <IResultObject> ] [-RemoveAdditionalAttribute <String[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByHeartbeat
Set-CMDiscoveryMethod -Heartbeat -SiteCode <String> [-Enabled <Boolean> ] [-PollingSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByNetworkDiscovery
Set-CMDiscoveryMethod -NetworkDiscovery -SiteCode <String> [-Enabled <Boolean> ] [-NetworkDiscoveryType <NetworkDiscoveryType> {ToplogyAndClient | ToplogyClientAndClientOperatingSystem | Topology} ] [-SlowNetworkSpeed <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Set-CMDiscoveryMethod cmdlet changes configuration settings of a discovery method. Discovery identifies computer and user resources that Microsoft System Center 2012 Configuration Manager can manage. When System Center 2012 Configuration Manager discovers a resource, System Center 2012 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 System Center 2012 Configuration Manager client and create custom queries and collections to logically group resources for related management tasks.

パラメーター

-ActiveDirectoryContainer<String[]>

Specifies an array of names of Active Directory containers.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-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).

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-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.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-ActiveDirectorySystemDiscovery

Indicates that the discovery method discovers computers from specified locations in AD DS.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-ActiveDirectoryUserDiscovery

Indicates that the discovery method discovers users from specified locations in AD DS.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-AddAdditionalAttribute<String[]>

Specifies an array of Active Directory object attributes. The cmdlet adds these attributes to the list of attributes that Configuration Manager discovers.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-DeltaDiscoveryIntervalMinutes<Int32>

Specifies how often, in minutes, to discover resources created or modified in AD DS since the last discovery cycle. To enable this feature, specify a value of $True for the EnableDeltaDiscovery parameter.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-DiscoverDistributionGroupsMembership<Boolean>

Indicates whether Configuration Manager discovers the membership of distribution groups.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-EnableActiveDirectorySiteBoundaryCreation<Boolean>

Indicates whether Configuration Manager creates Active Directory boundaries from AD DS discovery information.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Enabled<Boolean>

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.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-EnableDeltaDiscovery<Boolean>

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.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-EnableFilteringExpiredLogon<Boolean>

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.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-EnableFilteringExpiredPassword<Boolean>

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.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-EnableSubnetBoundaryCreation<Boolean>

Indicates whether Configuration Manager creates IP address range boundaries from AD DS discovery information.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Heartbeat

Indicates that the discovery method updates discovery records for Configuration Manager clients in the Configuration Manager database without discovering new resources.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-NetworkDiscovery

Indicates that the discovery method searches the network infrastructure for network devices, such as printers, routers, and bridges, that have IP addresses.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-NetworkDiscoveryType<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.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-PollingSchedule<IResultObject>

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.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-RemoveAdditionalAttribute<String[]>

Specifies an array of Active Directory object attributes. The cmdlet removes these attributes from the list of attributes that Configuration Manager discovers.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-SiteCode<String>

Specifies the site code for a Configuration Manager site.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-SlowNetworkSpeed<Boolean>

Indicates whether Configuration Manager makes adjustments to its discovery settings for networks that have low bandwidth.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-TimeSinceLastLogonDays<Int32>

Specifies the number of days since the last logon when the EnableFilteringExpiredLogon parameter had a value of $True.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-TimeSinceLastPasswordUpdateDays<Int32>

Specifies the number of days since that last password updated when the EnableFilteringExpiredPassword parameter had a value of $True.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Modify network discovery

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.

PS C:\> Set-CMDiscoveryMethod -NetworkDiscovery -SiteCode "CM4" -Enabled $True -NetworkDiscoveryType ToplogyAndClient -SlowNetworkSpeed $True

Example 2: Modify Active Directory system discovery

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.

PS C:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10 
PS C:\> Set-CMDiscoveryMethod -ActiveDirectorySystemDiscovery -SiteCode "CM4" -AddAdditionalAttribute "331", "431", "134" -DeltaDiscoveryIntervalMinutes 8 -Enabled $True -EnableDeltaDiscovery $True -EnableFilteringExpiredLogon $True -PollingSchedule $Schedule -RemoveAdditionalAttribute "123","cn" -TimeSinceLastLogonDays 80

Example 3: Modify forest discovery

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.

PS C:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10 
PS C:\> Set-CMDiscoveryMethod -ActiveDirectoryForestDiscovery -SiteCode "CM4" -EnableActiveDirectorySiteBoundaryCreation $True -Enabled $True  -EnableSubnetBoundaryCreation $True -PollingSchedule $Schedule

Example 4: Enable heartbeat discovery

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.

PS C:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10 
PS C:\> Set-CMDiscoveryMethod -Heartbeat -SiteCode "CM4" -Enabled $True -PollingSchedule $Schedule

関連トピック

Get-CMDiscoveryMethod

New-CMSchedule