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>]

Описание

Используйте этот командлет для получения членов коллекции. Коллекции могут включать устройства или пользователей, но не оба. При запросе коллекции этот командлет возвращает объекты для всех членов.

Дополнительные сведения см. в статье Общие сведения о коллекциях в Configuration Manager.

Примечание.

Запустите командлеты 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

Укажите идентификатор коллекции для запроса. Например, "XYZ0004B".

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CollectionName

Укажите имя коллекции для запроса.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

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

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

Тип:IResultObject
Aliases:Collection
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

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

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

  • *: несколько символов
  • ?: один символ
Тип:String
Aliases:ResourceName
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-ResourceId

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

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SmsId

Чтобы отфильтровать результаты, укажите SMSID ресурса. Например, "GUID:7a186367-7372-4841-889e-ba2e3aad1e85". Этот фильтр не учитывает регистр.

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

  • *: несколько символов
  • ?: один символ
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object