Get-CMCollection
获取设备或用户集合对象。
语法
Get-CMCollection
[-CollectionType <CollectionType>]
[-Name <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroup <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroupId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroupName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]Get-CMCollection
[-CollectionType <CollectionType>]
-Id <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]说明
使用此 cmdlet 获取设备或用户集合对象。
集合有助于将资源组织为可管理单元。 可以创建集合以满足客户端管理需求，并一次对多个资源执行操作。 大多数管理任务依赖于或需要使用一个或多个集合。
若要确定获取的集合类型的范围，请使用 Get-CMDeviceCollection 或 Get-CMUserCollection cmdlet。
如果未按名称、ID 或对象指定集合，此 cmdlet 将返回所有集合。
有关详细信息，请参阅 Configuration Manager 中的集合简介。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：按名称获取集合
此命令获取名为 testUser 的集合。
Get-CMCollection -Name "testUser"示例 2：获取分发点组的集合
此命令获取名为 dpg1 的分发点组对象，并使用管道运算符将对象传递给 Get-CMCollection，后者获取与分发点组关联的集合。
Get-CMDistributionPointGroup -Name "dpg1" | Get-CMCollection将内容分发到这些集合时，站点会自动分发到此分发点组的所有当前成员。 有关详细信息，请参阅 管理分发点组。
参数
-CollectionType
筛选要获取的集合类型。 此参数在功能上与使用 Get-CMDeviceCollection 或 Get-CMUserCollection cmdlet 相同。
| 类型: | CollectionType |
| 接受的值: | User, Device |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DistributionPointGroup
指定与此集合关联的分发点组对象。 若要获取此对象，请使用 Get-CMDistributionPointGroup cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-DistributionPointGroupId
指定与此集合关联的分发点组的 GUID。 此值是 GroupID 属性，它是用大括号括起来的标准 GUID，例如 {537e6303-69eb-4104-bf7b-7baf43ce2352}。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-DistributionPointGroupName
指定与此集合关联的分发点组的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Id
指定要获取的集合的 ID。 此值是 CollectionID 属性，例如 或 XYZ00012SMS00001。
| 类型: | String |
| 别名: | CollectionId |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定要获取的集合的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | True |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject[]
IResultObject
备注
有关此返回对象及其属性的详细信息，请参阅 SMS_Collection服务器 WMI 类。