New-CMDeviceCollection
Создание коллекции устройств.
Синтаксис
New-CMDeviceCollection
[-Comment <String>]
-LimitingCollectionName <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollection
[-Comment <String>]
-InputObject <IResultObject>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollection
[-Comment <String>]
-LimitingCollectionId <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Используйте этот командлет, чтобы создать коллекцию устройств на основе определенной ограничивающей коллекции. Ограничивающая коллекция определяет, какие устройства могут входить в созданную коллекцию устройств. Например, при использовании коллекции All Systems в качестве ограничивающей коллекции новая коллекция может включать любое устройство в иерархию Configuration Manager.
Затем вы можете добавить устройства в коллекцию с помощью правил членства. Чтобы добавить членов в коллекцию устройств, используйте один из следующих командлетов правила членства:
- Add-CMDeviceCollectionDirectMembershipRule
- Add-CMDeviceCollectionExcludeMembershipRule
- Add-CMDeviceCollectionIncludeMembershipRule
- Add-CMDeviceCollectionQueryMembershipRule
Дополнительные сведения см . в разделе Создание коллекций в Configuration Manager.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Создание коллекции устройств
Эта команда создает коллекцию для всех компьютеров под управлением Windows 11. Параметр LimitingCollectionName указывает, что любое устройство в коллекции All Systems может быть членом новой коллекции.
New-CMDeviceCollection -Name "Windows 11" -LimitingCollectionName "All Systems"Параметры
-Comment
Укажите необязательный комментарий для описания и идентификации этой коллекции.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Укажите объект для ограничивающей коллекции. Чтобы получить этот объект, используйте командлеты Get-CMCollection или Get-CMDeviceCollection .
| Тип: | IResultObject |
| Aliases: | LimitingCollection |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-LimitingCollectionId
Укажите идентификатор ограничивающей коллекции. Это значение является свойством CollectionID , например или XYZ00012SMS00001.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-LimitingCollectionName
Укажите имя ограничивающей коллекции.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Укажите имя новой коллекции устройств.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RefreshSchedule
Если для параметра RefreshType задано значение Periodic или Both, используйте этот параметр, чтобы задать расписание. Укажите объект расписания для, когда сайт выполняет полное обновление членства в коллекции. Чтобы получить этот объект, используйте командлет New-CMSchedule .
| Тип: | IResultObject |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RefreshType
Укажите способ обновления членства в коллекции:
-
Manual(1). Администратор вручную активирует обновление членства в консоли Configuration Manager или с помощью командлета Invoke-CMCollectionUpdate . -
Periodic(2) Сайт выполняет полное обновление по расписанию. В нем не используются добавочные обновления. Если тип не указан, это значение будет использоваться по умолчанию. -
Continuous(4). Сайт периодически оценивает новые ресурсы, а затем добавляет новых участников. Этот тип также называется добавочным обновлением. Он не выполняет полное обновление по расписанию. -
Both(6): сочетание иPeriodicContinuous, с добавочными обновлениями и полным обновлением по расписанию.
Если указать или PeriodicBoth, используйте параметр RefreshSchedule , чтобы задать расписание.
Примечание.
Значение None (0) функционально совпадает с значением Manual.
| Тип: | CollectionRefreshType |
| Допустимые значения: | None, Manual, Periodic, Continuous, Both |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object