Add-CMUserCollectionQueryMembershipRule
Добавьте правило членства запроса в коллекцию пользователей.
Синтаксис
Add-CMUserCollectionQueryMembershipRule
-InputObject <IResultObject>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionQueryMembershipRule
-CollectionId <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionQueryMembershipRule
-CollectionName <String>
[-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). Следующая команда добавляет правило членства с именем Удаленные пользователи по домену в коллекцию пользователей с именем Удаленные пользователи. Параметр QueryExpression использует переменную wql и указывает запрос, определяющий правило членства.
$wql = "select SMS_R_USER.ResourceID,SMS_R_USER.ResourceType,SMS_R_USER.Name,SMS_R_USER.UniqueUserName,SMS_R_USER.WindowsNTDomain from SMS_R_User"
Add-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -QueryExpression $wql -RuleName "Remote users by domain"
Параметры
-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-CMUserCollection.
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