Remove-CMCollectionQueryMembershipRule

  • Ссылка
Модуль:
ConfigurationManager

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

Синтаксис

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>]

Описание

Используйте этот командлет, чтобы удалить правило членства в запросе из коллекции устройств или пользователей. Правило запросов позволяет динамически обновлять членство в коллекции на основе запроса, выполняемого по расписанию. Нельзя удалить правила запросов из коллекций по умолчанию. Любое целевое семейство должно иметь идентификатор, который начинается с кода сайта, а не SMS. Дополнительные сведения см . в разделе Создание коллекций в Configuration Manager.

При удалении правила членства в запросах из коллекции несколько ресурсов больше не могут быть членами коллекции. Это действие может привести к тому, что любое развертывание программного обеспечения или конфигурации не будет применяться к ресурсам.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

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

Эта команда удаляет правило членства в запросе с именем TPM из коллекции устройств с именем Устройства Windows 10.

Remove-CMCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -RuleName "TPM" -Force

Параметры

-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:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Выполните команду, не запрашивая подтверждение.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

Укажите объект для коллекции, чтобы удалить правило. Чтобы получить этот объект, используйте командлеты Get-CMCollection, Get-CMDeviceCollection или 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:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object

Примечания

Этот командлет похож на Remove-CMDeviceCollectionQueryMembershipRule и Remove-CMUserCollectionQueryMembershipRule, которые относятся к типу коллекции. Этот командлет работает с коллекциями устройств или пользователей.