Add-CMDeviceCollectionIncludeMembershipRule

模块:

ConfigurationManager

将 include 成员资格规则添加到设备集合。

语法

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 将包含成员身份规则添加到设备集合。 include __ 成员资格规则包括应用该规则的设备集合的另一个集合的成员。

不能向默认集合添加成员身份规则。 您面向的任何集合都应具有以网站代码开头的 ID，而不是 SMS 。 可以包含默认集合，因此包含的集合的 ID 可以以 开始 SMS 。

如果包含的集合的成员资格发生更改，Configuration Manager 将按计划动态更新设备集合的成员身份。

向集合添加 include 成员资格规则时，资源可能会成为集合的成员。 此操作可能会导致任何软件或配置部署应用于包含的集合中的设备。

有关详细信息，请参阅如何在 Configuration Manager 中创建集合。

备注

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

示例

示例 1：添加包含成员身份规则

此命令使用 include 成员资格规则 添加 名为 All Systems 的设备集合。 规则将添加到名为 Device 的设备 集合。

Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "Device" -IncludeCollectionName "All Systems"

示例 2：使用管道将 include 成员资格规则添加到集合

此命令首先使用 Get-CMCollection cmdlet 获取名为 Device 的目标集合 对象。 然后，它使用管道运算符将对象传递到 Add-CMDeviceCollectionIncludeMembershipRule cmdlet，这将为名为 All Systems的设备集合添加 include 成员资格规则。

Get-CMCollection -Name "Device" | Add-CMDeviceCollectionIncludeMembershipRule -IncludeCollectionName "All Systems"

参数

-CollectionId

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

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

-CollectionName

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

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

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeCollection

指定要添加到规则中的已包含集合的对象。 若要获取此对象，请使用 Get-CMCollection 或 Get-CMDeviceCollection cmdlet。

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

-IncludeCollectionId

指定要添加到规则的包含集合的 ID。 此值为 CollectionID 属性，例如 ， XYZ00012 。 可以包含默认集合，因此此值可以从网站代码或 开始 SMS 。

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

-IncludeCollectionName

指定要添加到规则中的已包含集合的名称。

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

-InputObject

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

Type:	IResultObject
Aliases:	Collection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

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

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• Get-CMDeviceCollectionIncludeMembershipRule
• Remove-CMDeviceCollectionIncludeMembershipRule
• Get-CMCollection
• Get-CMDeviceCollection
• Add-CMUserCollectionIncludeMembershipRule
• 如何在 Configuration Manager 中创建集合