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, чтобы получить членов коллекции. В коллекции могут быть устройства или пользователи, но не оба. При запросе коллекции этот комлет возвращает объекты для всех участников.

Дополнительные сведения см. в обзоре Введение в коллекции в Configuration Manager.

Примечание

Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\> . Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.

Примеры

Пример 1. Получить члена коллекции с помощью оператора конвейера

Эта команда сначала использует командлет Get-CMCollection для получения объекта коллекции с именем UserCol1. Затем оператор конвейера передает объект Get-CMCollectionMember, который получает всех участников коллекции. Наконец, в этом примере используется комлет Select-Object для отображения только имен членов.

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

Укажите объект коллекции для запроса. Чтобы получить объект коллекции, используйте один из следующих cmdlets:

Вы также можете использовать оператор конвейера () для передать объект коллекции | Get-CMCollectionMemeber на командной строке.

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

-Name

Чтобы отфильтровать результаты, укажите имя ресурса в коллекции. Этот фильтр не является чувствительным к делу.

Можно использовать символы под диктовки:

  • *: Несколько символов
  • ?: Одиночный символ
Type:String
Aliases:ResourceName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-ResourceId

Чтобы отфильтровать результаты, укажите ИД ресурса. Например, 16777242. В этом окантовке возвращается запись только для этого ресурса в целевой коллекции.

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

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object