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
Дополнительные сведения см. в подборке 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