Remove-CMUserCollectionQueryMembershipRule
Удаление правила членства в запросе из коллекции пользователей.
Синтаксис
Remove-CMUserCollectionQueryMembershipRule
-InputObject <IResultObject>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMUserCollectionQueryMembershipRule
-CollectionName <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMUserCollectionQueryMembershipRule
-CollectionId <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Используйте этот командлет, чтобы удалить правило членства в запросе из коллекции пользователей.
Правило запросов позволяет динамически обновлять членство в коллекции на основе запроса, выполняемого по расписанию.
Нельзя удалить правила запросов из коллекций по умолчанию. Любое целевое семейство должно иметь идентификатор, который начинается с кода сайта, а не SMS.
Дополнительные сведения см . в разделе Создание коллекций в Configuration Manager.
При удалении правила членства в запросах из коллекции несколько ресурсов больше не могут быть членами коллекции. Это действие может привести к тому, что любое развертывание программного обеспечения или конфигурации не будет применяться к пользователям.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Удаление правила из коллекции с помощью имени коллекции
Эта команда удаляет правило с именем Удаленные пользователи по домену из коллекции с именем Удаленные пользователи.
Remove-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -RuleName "Remote Users by Domain"
Параметры
-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 |
-Force
Выполните команду, не запрашивая подтверждение.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Укажите объект для коллекции устройств, чтобы удалить правило. Чтобы получить этот объект, используйте командлеты Get-CMCollection или Get-CMUserCollection .
| Тип: | IResultObject |
| Aliases: | Collection |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-RuleName
Укажите имя правила запроса, удаляемого из коллекции.
| Тип: | String |
| 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