Remove-CMDeviceCollectionQueryMembershipRule
Удалите правило членства запроса из коллекции устройств.
Синтаксис
Remove-CMDeviceCollectionQueryMembershipRule
-InputObject <IResultObject>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionQueryMembershipRule
-CollectionName <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionQueryMembershipRule
-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-CMDeviceCollectionQueryMembershipRule -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: | False |
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 |
-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