Поделиться через

New-CMCollection

  • Ссылка
Модуль:
ConfigurationManager

Создайте коллекцию устройств или пользователей.

Синтаксис

New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -LimitingCollectionName <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -InputObject <IResultObject>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -LimitingCollectionId <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Используйте этот командлет для создания коллекции устройств или пользователей.

Ограничивающая коллекция определяет, какие ресурсы могут быть членом создаваемой коллекции. Например, при использовании коллекции All Systems в качестве ограничивающей коллекции, так как это коллекция устройств, новая коллекция устройств может включать любое устройство в иерархии Configuration Manager.

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

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

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

Примечание.

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

Примеры

Пример 1. Создание коллекции пользователей

Эта команда создает коллекцию пользователей с именем testUser , которая задает коллекцию All Users в качестве ограничивающей коллекции.

New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"

Пример 2. Установка ограничивающей коллекции через конвейер

Эта команда сначала использует Get-CMCollection для получения объекта коллекции All Users . Затем он использует оператор конвейера для передачи объекта командлету New-CMCollection , который создает коллекцию с именем testUser. Ограничивающей коллекцию для новой коллекции testUser является коллекция Все пользователи .

Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"

Параметры

-CollectionType

Укажите тип создаваемой коллекции. Этот параметр функционально совпадает с использованием командлетов New-CMDeviceCollection или New-CMUserCollection .

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

-Comment

Укажите необязательный комментарий для описания и идентификации этой коллекции.

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

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера: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 .

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

-LimitingCollectionId

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

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

-LimitingCollectionName

Укажите имя ограничивающей коллекции.

Тип:String
Aliases:LimitToCollectionName
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

-VariablePriority

Укажите целочисленное значение от 1 до 9 для приоритета переменных коллекции устройств. 1 — самый низкий приоритет, а 9 — самый высокий.

Чтобы создать переменные в коллекции устройств, используйте командлет New-CMDeviceCollectionVariable .

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

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject

Примечания

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