New-CMCollection

参考

模块:: ConfigurationManager

创建设备或用户集合。

语法

New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -LimitingCollectionName <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -InputObject <IResultObject>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -LimitingCollectionId <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 创建设备或用户集合。

限制集合确定哪些资源可以是您创建的集合的成员。例如，当使用 All Systems 集合作为限制集合时，由于它是设备集合，因此新设备集合可以包含 Configuration Manager 层次结构中的任意设备。

若要确定所创建集合的类型范围，您还可以使用 New-CMDeviceCollection 或 New-CMUserCollection cmdlet。

创建集合后，使用成员资格规则向集合中添加资源。若要向集合中添加成员，请使用其中一个 cmdlet 添加成员身份规则，例如：

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

备注

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

示例

示例 1：创建用户集合

此命令创建一个名为 testUser 的用户集合，该集合将 All Users 集合设置为限制集合。

New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"

示例 2：通过管道设置限制集合

此命令首先使用 Get-CMCollection 获取 All Users 集合对象。然后，它使用管道运算符将对象传递到 New-CMCollection cmdlet，该 cmdlet 将创建名为 testUser 的集合。新 testUser 集合的限制集合是 All Users 集合。

Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"

参数

-CollectionType

指定要创建的集合的类型。此参数在功能上与使用 New-CMDeviceCollection 或 New-CMUserCollection cmdlet 相同。

Type:	CollectionType
Accepted values:	User, Device
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Comment

指定用于描述和标识此集合的可选注释。

Type:	String
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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

指定限制集合的对象。若要获取此对象，请使用 Get-CMCollection、Get-CMDeviceCollection 或Get-CMUserCollection cmdlet。

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

-LimitingCollectionId

指定限制集合的 ID。此值为 CollectionID 属性，例如 XYZ00012 或 SMS00001 。

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

-LimitingCollectionName

指定限制集合的名称。

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

-RefreshSchedule

如果将 RefreshType 参数设置为 Periodic 或 Both ，则使用此参数设置计划。指定网站何时运行集合成员资格的完整更新的计划对象。若要获取此对象，请使用 New-CMSchedule cmdlet。

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

-RefreshType

指定如何更新集合成员身份：

Manual (1) ：管理员在 Configuration Manager 控制台或 Invoke-CMCollectionUpdate cmdlet 中手动触发成员身份更新。
Periodic (2) ：网站按计划执行完整更新。它不使用增量更新。如果不指定类型，则此值为默认值。
Continuous (4) ：网站会定期评估新资源，然后添加新成员。此类型也称为增量更新。它不会按计划执行完整更新。
Both (6) ：将和结合使用，并按计划进行增量更新和 Periodic Continuous 完整更新。

如果指定 Periodic 或 Both ，则使用 RefreshSchedule 参数设置计划。

备注

值 None (0) 与在功能上相同 Manual 。

Type:	CollectionRefreshType
Accepted values:	None, Manual, Periodic, Continuous, Both
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-VariablePriority

为设备集合变量的优先级指定 1-9 的整数值。 1 是最低优先级， 9 也是最高优先级。

若要在设备集合上创建变量，请使用 New-CMDeviceCollectionVariable cmdlet。

Type:	Int32
Aliases:	DeviceCollectionVariablePrecedence
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

-名称

指定新集合的名称。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

有关此返回对象及其属性的信息，请参阅SMS_Collection WMI 类。