Share via

Get-CMCollectionMember

  • 参考
模块:
ConfigurationManager

获取设备或用户集合的成员。

语法

Get-CMCollectionMember
   -CollectionName <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollectionMember
   -CollectionId <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollectionMember
   -InputObject <IResultObject>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

说明

使用此 cmdlet 可获取集合的成员。 集合可以包括设备或用户，但不能同时包括这两者。 查询集合时，此 cmdlet 返回所有成员的对象。

有关详细信息，请参阅 Configuration Manager 中集合简介。

备注

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

示例

示例 1：使用管道运算符获取集合的成员

此命令首先使用 Get-CMCollection cmdlet 获取名为 UserCol1的集合对象。 然后，它使用管道运算符将对象传递到 Get-CMCollectionMember，Get-CMCollectionMember将获取集合中的所有成员。 最后，此示例使用 Select-Object cmdlet 仅显示成员名称。

Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name

示例 2：按名称获取集合的成员

此命令查询 集合 DeviceCol1 中名称以 开头的成员 domain 。 通配符的星号 * () 匹配多个字符。 因此结果可以包含"domain1"或"domain-controller"等名称。

Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"

示例 3：将集合详细信息导出到 CSV

此示例查询XYZ0004B设备集合中的一组属性，并存储到变量中的 $collMem 。 第二行使用 CSV 格式将该数据 (逗号) ，并输出到文件。

$collMem = Get-CMCollectionMember -CollectionId "XYZ0004B" | Select-Object Name,Domain,LastLogonUser,DeviceOS,DeviceOSBuild,MACAddress,SerialNumber
$collMem | ConvertTo-Csv -NoTypeInformation | Out-File -FilePath "C:\output\XYZ0004B.csv"

参数

-CollectionId

指定要查询的集合的 ID。 例如，"XYZ0004B"。

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

-CollectionName

指定要查询的集合的名称。

Type:String
Position:Named
Default value:None
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

指定要查询的集合对象。 若要获取集合对象，请使用以下 cmdlet 之一：

您还可以使用管道运算符 () 将集合对象传递到命令行上的 | Get-CMCollectionMemeber。

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

-ResourceId

若要筛选结果，请指定资源 ID。 例如，16777242。 cmdlet 仅返回目标集合中该资源的记录。

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

-SmsId

若要筛选结果，请指定资源的 SMSID。 例如，"GUID:7a186367-7372-4841-889e-ba2e3aad1e85"。 此筛选器不区分大小写。

可以使用通配符：

  • *：多个字符
  • ?：单个字符
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-名称

若要筛选结果，请指定集合中资源的名称。 此筛选器不区分大小写。

可以使用通配符：

  • *：多个字符
  • ?：单个字符
Type:String
Aliases:ResourceName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object