Add-CMDeviceCollectionQueryMembershipRule

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

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

Синтаксис

Add-CMDeviceCollectionQueryMembershipRule
   -CollectionId <String>
   [-PassThru]
   -QueryExpression <String>
   -RuleName <String>
   [-ValidateQueryHasResult]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionQueryMembershipRule
   -CollectionName <String>
   [-PassThru]
   -QueryExpression <String>
   -RuleName <String>
   [-ValidateQueryHasResult]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionQueryMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -QueryExpression <String>
   -RuleName <String>
   [-ValidateQueryHasResult]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Примечание.

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

Примеры

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

В этом примере сначала сохраняется инструкция WMI Query Language (WQL) в переменной wql . Следующая команда добавляет правило членства с именем TPM в коллекцию устройств с именем Устройства Windows 10. Параметр QueryExpression использует переменную wql и задает запрос, определяющий правило членства.

$wql = "select SMS_R_System.ResourceId, SMS_R_System.ResourceType, SMS_R_System.Name, SMS_R_System.SMSUniqueIdentifier, SMS_R_System.ResourceDomainORWorkgroup, SMS_R_System.Client from  SMS_R_System inner join SMS_G_System_TPM on SMS_G_System_TPM.ResourceID = SMS_R_System.ResourceId"

Add-CMDeviceCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -QueryExpression $wql -RuleName "TPM"

Параметры

-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

-QueryExpression

Укажите выражение WMI Query Language (WQL), которое сайт использует для обновления коллекции устройств.

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

-RuleName

Укажите имя правила запроса, добавляемого в коллекцию.

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

-ValidateQueryHasResult

Добавьте этот параметр, чтобы протестировать выражение запроса перед добавлением правила. При выполнении командлета с этим параметром, если выражение запроса не имеет результатов, командлет возвращает следующее сообщение об ошибке: No object corresponds to the specified parameters. В этом случае запрос не добавляется в коллекцию.

Если вы знаете, что запрос в настоящее время возвращает ноль результатов, но по-прежнему хотите добавить правило, не используйте этот параметр.

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