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

Add-CMDeviceCollectionIncludeMembershipRule

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

Добавьте правило включения членства в коллекцию устройств.

Синтаксис

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Нельзя добавлять правила членства в коллекции по умолчанию. Любое целевое семейство должно иметь идентификатор, который начинается с кода сайта, а не SMS. Вы можете включить коллекцию по умолчанию, поэтому идентификатор включенной коллекции может начинаться с SMS.

Configuration Manager динамически обновляет членство в коллекции устройств по расписанию, если членство в включенной коллекции меняется.

При добавлении правила включения членства в коллекцию ресурсы могут стать членами коллекции. Это действие может привести к применению любого развертывания программного обеспечения или конфигурации к устройствам в включенной коллекции.

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

Примечание.

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

Примеры

Пример 1. Добавление правила включения членства

Эта команда добавляет коллекцию устройств с именем All Systems с правилом включения членства. Правило добавляется в коллекцию устройств с именем Device.

Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "Device" -IncludeCollectionName "All Systems"

Пример 2. Добавление правила членства включения в коллекцию с помощью конвейера

Эта команда сначала использует командлет Get-CMCollection для получения целевого объекта коллекции с именем Device. Затем он использует оператор конвейера для передачи объекта в командлет Add-CMDeviceCollectionIncludeMembershipRule , который добавляет правило включения членства для коллекции устройств с именем All Systems.

Get-CMCollection -Name "Device" | Add-CMDeviceCollectionIncludeMembershipRule -IncludeCollectionName "All Systems"

Параметры

-CollectionId

Укажите идентификатор коллекции устройств, чтобы добавить правило. Это значение является свойством CollectionID , например XYZ00012. Так как в коллекциях по умолчанию нет правил членства, этот идентификатор начинается с кода сайта, а не SMS.

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

-CollectionName

Укажите имя коллекции устройств, чтобы добавить правило.

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

-Confirm

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

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

-IncludeCollection

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

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

-IncludeCollectionId

Укажите идентификатор включенной коллекции, добавляемой в правило. Это значение является свойством CollectionID , например XYZ00012. Вы можете включить коллекции по умолчанию, поэтому это значение может начинаться с кода сайта или SMS.

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

-IncludeCollectionName

Укажите имя включенной коллекции, добавляемой в правило.

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

-InputObject

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

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

-PassThru

Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.

Тип:SwitchParameter
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