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.

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

Дополнительные сведения см. в подборке How to create collections in Configuration Manager.

Примечание

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

Примеры

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

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

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

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

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

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

Параметры

-CollectionType

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

Type:	CollectionType
Accepted values:	User, Device
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Comment

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	IResultObject
Aliases:	LimitingCollection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-LimitingCollectionId

Укажите ID ограничивающего сбора. Это значение является свойством CollectionID, например, XYZ00012 или SMS00001 .

Type:	String
Aliases:	LimitToCollectionId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LimitingCollectionName

Укажите имя лимита коллекции.

Type:	String
Aliases:	LimitToCollectionName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Укажите имя новой коллекции.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RefreshSchedule

Если параметр RefreshType задан либо или, используйте этот Periodic параметр для Both заданного расписания. Укажите объект расписания для того, когда на сайте выполняется полное обновление членства в коллекции. Чтобы получить этот объект, используйте cmdlet New-CMSchedule.

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RefreshType

Укажите, как обновляется членство в коллекции:

Manual(1). Администратор вручную запускает обновление членства в консоли Configuration Manager или с помощью команды Invoke-CMCollectionUpdate.
Periodic (2). Сайт делает полное обновление по расписанию. Он не использует дополнительные обновления. Если вы не указываете тип, это значение является по умолчанию.
Continuous (4): Сайт периодически оценивает новые ресурсы, а затем добавляет новых участников. Этот тип также известен как постепенное обновление. Он не обновляется в полном объеме по расписанию.
Both (6): сочетание как дополнительных обновлений, так и полного обновления Periodic Continuous по расписанию.

Если вы указываете Periodic или Both используете параметр RefreshSchedule, чтобы задать расписание.

Примечание

Значение None (0) функционально такое же, как Manual .

Type:	CollectionRefreshType
Accepted values:	None, Manual, Periodic, Continuous, Both
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-VariablePriority

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

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

Type:	Int32
Aliases:	DeviceCollectionVariablePrecedence
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject

Примечания

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