Set-CMDiscoveryMethod

模块:

ConfigurationManager

更改发现方法的配置设置。

语法

Set-CMDiscoveryMethod
   [-ActiveDirectoryForestDiscovery]
   [-EnableActiveDirectorySiteBoundaryCreation <Boolean>]
   [-Enabled <Boolean>]
   [-EnableSubnetBoundaryCreation <Boolean>]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

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

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

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

Set-CMDiscoveryMethod
   [-Enabled <Boolean>]
   [-NetworkDiscovery]
   [-NetworkDiscoveryType <NetworkDiscoveryType>]
   [-PassThru]
   [-SiteCode <String>]
   [-SlowNetworkSpeed <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMDiscoveryMethod
   [-Enabled <Boolean>]
   [-Heartbeat]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-CMDiscoveryMethod cmdlet 更改发现方法的配置设置。 发现标识 Configuration Manager 可以管理的计算机和用户资源。 当 Configuration Manager 发现资源时，Configuration Manager 会在 Configuration Manager 数据库中为资源及其相关信息创建一条记录。 然后，可以使用发现信息来帮助安装 Configuration Manager 客户端，并创建自定义查询和集合，以逻辑方式对资源进行分组，以执行相关管理任务。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1：修改网络发现

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

此命令修改具有站点代码 CM4 的站点的网络发现。 命令指定拓扑和客户端网络发现以及慢网络速度选项。 该命令还启用发现。

示例 2：修改 Active Directory 系统发现

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

第一个命令使用 New-CMSchedule cmdlet 创建计划对象，并将其存储在 $Schedule 变量中。

第二个命令为具有站点代码 CM4 的站点启用计算机发现。 命令将存储在 $Schedule 变量中的计划对象指定为轮询计划，并使增量发现能够查找自上次发现以来的新计算机和已修改的计算机。 命令指定每 8 分钟发生一次增量发现。

第二个命令还将找到的计算机限制为用户在过去 80 天内登录的计算机。 此外，该命令还会从用于限制计算机的属性中添加和删除指定的属性。

示例 3：修改林发现

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

第一个命令使用 New-CMSchedule cmdlet 创建计划对象，然后将其存储在 $Schedule 变量中。

第二个命令启用具有站点代码 CM4 的此发现站点。 命令将存储在 $Schedule 变量中的计划对象指定为轮询间隔，并启用 Active Directory 边界创建和子网边界创建。

示例 4：启用检测信号发现

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

第一个命令使用 New-CMSchedule cmdlet 创建计划对象，并将其存储在 $Schedule 变量中。

第二个命令启用检测信号发现，并将存储在 $Schedule 变量中的对象指定为具有站点代码 CM4 的站点的轮询计划。

参数

-ActiveDirectoryContainer

指定 Active Directory 容器的名称数组。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ActiveDirectoryForestDiscovery

指示发现方法从 Active Directory 域服务 (AD DS) 中的指定位置发现安全组，包括本地组、全局组和通用组。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ActiveDirectoryGroupDiscovery

指示发现方法发现有关以前从 AD DS 中的指定位置发现的计算机的其他信息，包括计算机组织单位 (OU) 和组成员身份。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ActiveDirectorySystemDiscovery

指示发现方法从 AD DS 中的指定位置发现计算机。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ActiveDirectoryUserDiscovery

指示发现方法从 AD DS 中的指定位置发现用户。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-AddActiveDirectoryContainer

类型:	String[]
别名:	AddActiveDirectoryContainers
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddAdditionalAttribute

指定 Active Directory 对象属性的数组。 cmdlet 将这些属性添加到 Configuration Manager 发现的属性列表中。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddGroupDiscoveryScope

类型:	ADGroupDiscoveryScope[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ClearActiveDirectoryContainer

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-DeltaDiscoveryMins

类型:	Int32
别名:	DeltaDiscoveryIntervalMinutes, DeltaDiscoveryIntervalMins
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DiscoverDistributionGroupMembership

类型:	Boolean
别名:	DiscoverDistributionGroupsMembership
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableActiveDirectorySiteBoundaryCreation

指示 Configuration Manager 是否根据 AD DS 发现信息创建 Active Directory 边界。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Enabled

指示是否启用 Configuration Manager 发现。 如果将值指定为 $False，则 Configuration Manager 不会使用此发现发现资源。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableDeltaDiscovery

指示 Configuration Manager 是否发现自上次发现周期以来在 AD DS 中创建或修改的资源。 如果为此参数指定值 $True，请为 DeltaDiscoveryIntervalMinutes 参数指定值。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableFilteringExpiredLogon

指示 Configuration Manager 是否仅发现在指定天数内登录到域的计算机。 使用 TimeSinceLastLogonDays 参数指定天数。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableFilteringExpiredPassword

指示 Configuration Manager 是否仅发现在指定天数内更新了其计算机帐户密码的计算机。 使用 TimeSinceLastPasswordUpdateDays 参数指定天数。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableIncludeGroup

{{ Fill EnableIncludeGroup Description }}

类型:	Boolean
别名:	EnableIncludeGroups
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableRecursive

{{ Fill EnableRecursive Description }}

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableSubnetBoundaryCreation

指示 Configuration Manager 是否根据 AD DS 发现信息创建 IP 地址范围边界。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Heartbeat

指示发现方法更新 Configuration Manager 数据库中 Configuration Manager 客户端的发现记录而不发现新资源。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-IncludeGroup

类型:	SwitchParameter
别名:	IncludeGroups
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NetworkDiscovery

指示发现方法在网络基础结构中搜索具有 IP 地址的网络设备，例如打印机、路由器和网桥。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NetworkDiscoveryType

指定网络发现类型。 如果指定 NetworkDiscovery 参数，请指定以下类型之一：

• ToplogyAndClient。 发现将查找网络和潜在客户端设备的拓扑。
• ToplogyClientAndClientOperatingSystem。 发现将查找网络的拓扑。 发现会查找潜在的客户端设备及其操作系统和版本。
• 拓扑学。 发现通过发现 IP 子网和路由器来查找网络的拓扑。

类型:	NetworkDiscoveryType
接受的值:	Topology, TopologyAndClient, ToplogyAndClient, TopologyClientAndClientOperatingSystem, ToplogyClientAndClientOperatingSystem
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PollingSchedule

指定计划对象。 若要获取计划对象，请使用 New-CMSchedule cmdlet。 轮询计划确定 Configuration Manager 尝试发现组、系统或用户数据的频率。

类型:	IResultObject
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Recursive

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveActiveDirectoryContainer

类型:	String[]
别名:	RemoveActiveDirectoryContainers
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveAdditionalAttribute

指定 Active Directory 对象属性的数组。 cmdlet 从 Configuration Manager 发现的属性列表中删除这些属性。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveGroupDiscoveryScope

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SiteCode

指定 Configuration Manager 站点的站点代码。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SlowNetworkSpeed

指示 Configuration Manager 是否调整其低带宽网络的发现设置。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TimeSinceLastLogonDays

指定自上次登录以来的天数， 当 EnableFilteringExpiredLogon 参数的值为 $True。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TimeSinceLastPasswordUpdateDays

指定自上次密码更新以来的天数， 当 EnableFilteringExpiredPassword 参数的值为 $True。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UserName

{{ Fill UserName Description }}

类型:	String
别名:	DiscoveryAccountUserName
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

相关链接

• Get-CMDiscoveryMethod
• New-CMSchedule