Remove-CMDeviceCollectionQueryMembershipRule

Ссылка

Модуль:: ConfigurationManager

Удалите правило членства запроса из коллекции устройств.

Синтаксис

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