Add-CMDeviceCollectionQueryMembershipRule
Добавьте правило членства запроса в коллекцию устройств.
Синтаксис
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>]
Описание
Используйте этот комдлет, чтобы добавить правило членства запроса в коллекцию устройств.
Правило запроса позволяет динамически обновлять членство коллекции на основе запроса, запускаемого по расписанию.
Нельзя добавлять правила членства в коллекции по умолчанию. В любой коллекции, на которую вы нацелены, должен быть ID, который начинается с кода сайта, а не SMS
.
Дополнительные сведения см. в подборке How to create collections in Configuration Manager.
Примечание
Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.
Примеры
Пример 1. Добавление правила членства в запросе
В этом примере сначала в переменной wql хранится утверждение WMI Query Language (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
Укажите ID коллекции устройств, чтобы добавить правило. Это значение является свойством CollectionID, XYZ00012
например. Так как вы не можете добавить правила членства в коллекции по умолчанию, этот код начинается с кода сайта, а не SMS
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Укажите имя коллекции устройств, чтобы добавить правило.
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 |
-DisableWildcardHandling
Этот параметр рассматривает символы под диктовки как буквальные значения символов. Вы не можете объединить его с ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Этот параметр обрабатывает символы под диктовки и может привести к неожиданному поведению (не рекомендуется). Вы не можете объединить его с DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Укажите объект для коллекции устройств, чтобы добавить правило. Чтобы получить этот объект, используйте cmdlets Get-CMCollection или Get-CMDeviceCollection.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Добавьте этот параметр, чтобы вернуть объект, который представляет элемент, с которым вы работаете. По умолчанию этот комдлет может не создавать выходных данных.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryExpression
Укажите выражение WMI Query Language (WQL), которое сайт использует для обновления коллекции устройств.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RuleName
Укажите имя правила запроса для добавления в коллекцию.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValidateQueryHasResult
Добавьте этот параметр, чтобы проверить выражение запроса перед добавлением правила. При запуске этого параметра, если выражение запроса не имеет результатов, он возвращает следующее сообщение об ошибке. В этом случае запрос не добавляется в No object corresponds to the specified parameters.
коллекцию.
Если вы знаете, что запрос в настоящее время возвращает нулевые результаты, но все же хотите добавить правило, не используйте этот параметр.
Type: | SwitchParameter |
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