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-CMCollection
• Get-CMDeviceCollection
• Get-CMUserCollection

Оператор конвейера (|) также можно использовать для передачи объекта коллекции в 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

Связанные ссылки

• Copy-CMCollection
• Export-CMCollection
• Get-CMCollection
• Get-CMCollectionSetting
• Import-CMCollection
• Invoke-CMCollectionUpdate
• New-CMCollection
• Remove-CMCollection
• Set-CMCollection
• Get-CMDeviceCollection
• Get-CMUserCollection
• Общие сведения о коллекциях в Configuration Manager