Add-CMDeviceCollectionDirectMembershipRule

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

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

Синтаксис

Add-CMDeviceCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Примечание.

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

Примеры

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

Эта команда добавляет правило прямого членства в коллекцию устройств с идентификатором XYZ00056. Он добавляет ресурс с идентификатором 16777219 в коллекцию.

Add-CMDeviceCollectionDirectMembershipRule -CollectionId "XYZ00056" -ResourceId 16777219

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

Эта команда сначала использует командлет Get-CMCollection для получения объекта коллекции с именем testCollection. Затем оператор конвейера используется для передачи объекта в командлет Add-CMDeviceCollectionDirectMembershipRule , который добавляет правило прямого членства в объект коллекции устройств. Он добавляет устройство с идентификатором 16777219 в коллекцию.

Get-CMCollection -Name "testCollection" | Add-CMDeviceCollectionDirectMembershipRule -ResourceId 16777219

Параметры

-CollectionId

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

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

-CollectionName

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

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

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

-PassThru

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

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

-Resource

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

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

-ResourceId

Укажите массив идентификаторов ресурсов для добавления в коллекцию устройств с помощью этого правила прямого членства. Это значение является свойством ResourceID , например 16777219.

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

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object