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>]
Описание
Используйте этот кодлет, чтобы удалить правило членства запроса из коллекции пользователей.
Правило запроса позволяет динамически обновлять членство коллекции на основе запроса, запускаемого по расписанию.
Вы не можете удалить правила запроса из коллекций по умолчанию. В любой коллекции, на которую вы нацелены, должен быть ID, который начинается с кода сайта, а не SMS
.
Дополнительные сведения см. в подборке How to create collections in Configuration Manager.
При исключении правила членства запроса из коллекции несколько ресурсов могут перестать быть членами коллекции. Это действие может привести к тому, что любое развертывание программного обеспечения или конфигурации не будет применяться к пользователям.
Примечание
Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.
Примеры
Пример 1. Удаление правила из коллекции с помощью имени коллекции
Эта команда удаляет правило с именем Удаленные пользователи по домену из коллекции с именем Удаленные пользователи.
Remove-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -RuleName "Remote Users by Domain"
Параметры
-CollectionId
Укажите ID коллекции пользователей, чтобы удалить правило. Это значение является свойством CollectionID, XYZ00012
например. Так как вы не можете удалить правила запроса из коллекций по умолчанию, этот код начинается с кода сайта, а не SMS
.
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Укажите имя коллекции пользователей, чтобы удалить правило.
Type: | String |
Aliases: | Name |
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 |
-InputObject
Укажите объект для коллекции устройств, чтобы удалить правило. Чтобы получить этот объект, используйте cmdlets Get-CMCollection или Get-CMUserCollection.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RuleName
Укажите имя правила запроса, которое необходимо удалить из коллекции.
Type: | String |
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 |
-Принудительно
Запустите команду, не запрашивая подтверждения.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object