Get-CMCollection

Получение объекта коллекции устройств или пользователей.

Синтаксис

Get-CMCollection
   [-CollectionType <CollectionType>]
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Описание

Используйте этот командлет, чтобы получить объект коллекции устройств или пользователей.

С помощью коллекций можно упорядочивать ресурсы в управляемые единицы. Вы можете создавать коллекции в соответствии с потребностями управления клиентами и выполнять операции с несколькими ресурсами одновременно. Большинство задач управления используют или требуют использования одной или нескольких коллекций.

Чтобы определить область получаемой коллекции, используйте командлеты Get-CMDeviceCollection или Get-CMUserCollection .

Если не указать коллекцию по имени, идентификатору или объекту, этот командлет возвращает все коллекции.

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

Примечание.

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

Примеры

Пример 1. Получение коллекции по имени

Эта команда возвращает коллекцию с именем testUser.

Get-CMCollection -Name "testUser"

Пример 2. Получение коллекции для группы точек распространения

Эта команда получает объект группы точек распространения с именем dpg1 и использует оператор конвейера для передачи объекта в Get-CMCollection, который получает коллекции, связанные с группой точек распространения.

Get-CMDistributionPointGroup -Name "dpg1" | Get-CMCollection

При распространении содержимого в эти семейства сайт автоматически распространяется среди всех текущих членов этой группы точек распространения. Дополнительные сведения см. в статье Управление группами точек распространения.

Параметры

-CollectionType

Отфильтруйте тип коллекции для получения. Функционально этот параметр совпадает с использованием командлетов Get-CMDeviceCollection или Get-CMUserCollection .

Тип:CollectionType
Допустимые значения:User, Device
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

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

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

-DistributionPointGroup

Укажите объект группы точек распространения, связанный с этой коллекцией. Чтобы получить этот объект, используйте командлет Get-CMDistributionPointGroup .

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

-DistributionPointGroupId

Укажите GUID для группы точек распространения, связанной с этой коллекцией. Это значение является свойством GroupID , которое представляет собой стандартный GUID, окруженный фигурными скобками, например {537e6303-69eb-4104-bf7b-7baf43ce2352}.

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

-DistributionPointGroupName

Укажите имя группы точек распространения, связанной с этой коллекцией.

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

-ForceWildcardHandling

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

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

-Id

Укажите идентификатор коллекции для получения. Это значение является свойством CollectionID , например или XYZ00012SMS00001.

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

-Name

Укажите имя коллекции для получения.

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject[]

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_Collection класс WMI сервера.