Get-CMCollectionMember

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

语法

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,后者获取集合中的所有成员。 最后,此示例使用 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"

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-CollectionName

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

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

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

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

类型:IResultObject
别名:Collection
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

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

可以使用通配符:

  • *:多个字符
  • ?:单个字符
类型:String
别名:ResourceName
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-ResourceId

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

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SmsId

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

可以使用通配符:

  • *:多个字符
  • ?:单个字符
类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object