New-CMDeviceCollection

Ссылка

Модуль:: ConfigurationManager

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

Синтаксис

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.

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

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

Примечание

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

Примеры

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

Эта команда создает коллекцию для всех компьютеров, Windows 11. Параметр LimitingCollectionName указывает, что любое устройство из коллекции All Systems может быть членом новой коллекции.

New-CMDeviceCollection -Name "Windows 11" -LimitingCollectionName "All Systems"

Параметры

-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

-InputObject

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

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

-LimitingCollectionId

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

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

-LimitingCollectionName

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

Type:	String
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

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object