Add-CMDeviceCollectionDirectMembershipRule

参考

模块:: ConfigurationManager

将直接成员身份规则添加到设备集合。

语法

Add-CMDeviceCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 将直接成员身份规则添加到设备集合。直接成员身份规则允许显式选择设备集合的成员。无法将成员身份规则添加到默认集合。目标的任何集合都应具有以网站代码开头的 ID，而不是 SMS。有关详细信息，请参阅如何在 Configuration Manager 中创建集合。

注意

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

示例

示例 1：添加直接成员身份规则

此命令将直接成员身份规则添加到 ID XYZ00056的设备集合。它将 ID 16777219 的资源添加到集合。

Add-CMDeviceCollectionDirectMembershipRule -CollectionId "XYZ00056" -ResourceId 16777219

示例 2：使用管道添加直接成员身份规则

此命令首先使用 Get-CMCollection cmdlet 获取名为 testCollection 的集合对象。然后，它使用管道运算符将对象传递给 Add-CMDeviceCollectionDirectMembershipRule cmdlet，后者将直接成员身份规则添加到设备集合对象。它将 ID 16777219 的设备添加到集合。

Get-CMCollection -Name "testCollection" | Add-CMDeviceCollectionDirectMembershipRule -ResourceId 16777219

参数

-CollectionId

指定要添加规则的设备集合的 ID。此值是 CollectionID 属性，例如 XYZ00012。由于无法向默认集合添加成员身份规则，因此此 ID 以网站代码开头，而不是 SMS。

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

-CollectionName

指定要添加规则的设备集合的名称。

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

-Confirm

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

为设备集合指定对象以添加规则。若要获取此对象，请使用 Get-CMCollection 或 Get-CMDeviceCollection cmdlet。

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

-PassThru

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

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

-Resource

使用此直接成员身份规则指定要添加到设备集合的资源对象数组。若要获取此对象，请使用 Get-CMResource cmdlet 或带有 -Resource 参数的 Get-CMDevice cmdlet。

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

-ResourceId

使用此直接成员身份规则指定要添加到设备集合的资源 ID 数组。此值是 ResourceID 属性，例如 16777219。

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

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

反馈

此页面是否有帮助？