Remove-CMCollectionQueryMembershipRule
Удаление правила членства запроса из устройства или коллекции пользователей.
Синтаксис
Remove-CMCollectionQueryMembershipRule
-InputObject <IResultObject>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionQueryMembershipRule
-CollectionName <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionQueryMembershipRule
-CollectionId <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Используйте этот комлет, чтобы удалить правило членства запроса из устройства или коллекции пользователей.
Правило запроса позволяет динамически обновлять членство коллекции на основе запроса, запускаемого по расписанию.
Вы не можете удалить правила запроса из коллекций по умолчанию. В любой коллекции, на которую вы нацелены, должен быть ID, который начинается с кода сайта, а не SMS
.
Дополнительные сведения см. в подборке How to create collections in Configuration Manager.
При исключении правила членства запроса из коллекции несколько ресурсов могут перестать быть членами коллекции. Это действие может привести к тому, что любое развертывание программного обеспечения или конфигурации не будет применяться к ресурсам.
Примечание
Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.
Примеры
Пример 1. Удаление правил членства запроса для коллекции устройств
Эта команда удаляет правило членства запроса с именем TPM из коллекции устройств с именем Windows 10 устройств.
Remove-CMCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -RuleName "TPM" -Force
Параметры
-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: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Укажите объект для коллекции, чтобы удалить правило. Чтобы получить этот объект, используйте комлеты Get-CMCollection, Get-CMDeviceCollectionили 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: | None |
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
Примечания
Этот комлет похож на Remove-CMDeviceCollectionQueryMembershipRule и Remove-CMUserCollectionQueryMembershipRule, которые специфичнее типа коллекции. Этот комлет работает с устройствами или коллекциями пользователей.
Связанные ссылки
- Get-CMCollectionQueryMembershipRule
- Remove-CMCollectionDirectMembershipRule
- Remove-CMCollectionExcludeMembershipRule
- Remove-CMCollectionIncludeMembershipRule
- Add-CMDeviceCollectionQueryMembershipRule
- Add-CMUserCollectionQueryMembershipRule
- Get-CMDeviceCollectionQueryMembershipRule
- Get-CMUserCollectionQueryMembershipRule
- Get-CMCollection
- Get-CMDeviceCollection
- Get-CMUserCollection
- Создание коллекций в диспетчере конфигурации