New-CMCollection
创建设备或用户集合。
语法
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 创建设备或用户集合。
限制集合确定哪些资源可以是你创建的集合的成员。 例如，使用 “所有系统” 集合作为限制集合时，由于它是设备集合，因此新的设备集合可以包含 Configuration Manager 层次结构中的任何设备。
若要确定所创建的集合类型的范围，还可以使用 New-CMDeviceCollection 或 New-CMUserCollection cmdlet。
创建集合后，使用成员身份规则将资源添加到集合。 若要将成员添加到集合，请使用其中一个 cmdlet 添加成员身份规则，例如：
有关详细信息，请参阅 如何在 Configuration Manager 中创建集合。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：创建用户集合
此命令创建名为 testUser 的用户集合，该集合将 “所有用户” 集合设置为限制集合。
New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"示例 2：通过管道设置限制集合
此命令首先使用 Get-CMCollection 来获取 “所有用户” 集合对象。 然后，它使用管道运算符将 对象传递给 New-CMCollection cmdlet，后者将创建名为 testUser 的集合。 新 testUser 集合的限制集合是 All Users 集合。
Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"参数
-CollectionType
指定要创建的集合的类型。 此参数在功能上与使用 New-CMDeviceCollection 或 New-CMUserCollection cmdlet 相同。
| 类型: | CollectionType |
| 接受的值: | User, Device |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Comment
指定可选注释来描述和标识此集合。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | 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 或 Get-CMUserCollection cmdlet。
| 类型: | IResultObject |
| 别名: | LimitingCollection |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-LimitingCollectionId
指定限制集合的 ID。 此值是 CollectionID 属性，例如 或 XYZ00012SMS00001。
| 类型: | String |
| 别名: | LimitToCollectionId |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-LimitingCollectionName
指定限制集合的名称。
| 类型: | String |
| 别名: | LimitToCollectionName |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定新集合的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-RefreshSchedule
如果将 RefreshType 参数设置为 Periodic 或 Both，请使用此参数设置计划。 指定站点何时运行集合成员身份的完整更新的计划对象。 若要获取此对象，请使用 New-CMSchedule cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RefreshType
指定集合成员身份的更新方式：
-
Manual(1) ：管理员在 Configuration Manager 控制台中或使用 Invoke-CMCollectionUpdate cmdlet 手动触发成员身份更新。 -
Periodic(2) ：站点按计划执行完全更新。 它不使用增量更新。 如果未指定类型，则此值为默认值。 -
Continuous(4) ：站点定期评估新资源，然后添加新成员。 此类型也称为 增量更新。 它不会按计划执行完全更新。 -
Both(6) ：和Continuous的组合Periodic，同时按计划进行增量更新和完整更新。
如果指定 Periodic 或 Both，请使用 RefreshSchedule 参数设置计划。
注意
(None 0) 的值在功能上与 Manual相同。
| 类型: | CollectionRefreshType |
| 接受的值: | None, Manual, Periodic, Continuous, Both |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-VariablePriority
为设备集合变量的优先级指定一个介于 1-9 的整数值。
1 是最低优先级，是 9 最高优先级。
若要在设备集合上创建变量，请使用 New-CMDeviceCollectionVariable cmdlet。
| 类型: | Int32 |
| 别名: | DeviceCollectionVariablePrecedence |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject
备注
有关此返回对象及其属性的详细信息，请参阅 SMS_Collection服务器 WMI 类。