Поделиться через

Set-CMQuery

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

Настройте запрос Configuration Manager.

Синтаксис

Set-CMQuery
   [-Comment <String>]
   [-Expression <String>]
   -InputObject <IResultObject>
   [-LimitToCollectionId <String>]
   [-NewName <String>]
   [-PassThru]
   [-TargetClassName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMQuery
   [-Comment <String>]
   [-Expression <String>]
   -Id <String>
   [-LimitToCollectionId <String>]
   [-NewName <String>]
   [-PassThru]
   [-TargetClassName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMQuery
   [-Comment <String>]
   [-Expression <String>]
   [-LimitToCollectionId <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-TargetClassName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Используйте этот командлет для настройки запроса в Configuration Manager. Запросы Configuration Manager определяют выражение WMI Query Language (WQL) для получения сведений из базы данных сайта на основе предоставленных вами критериев. WQL похож на SQL, но по-прежнему проходит через поставщик SMS, а не непосредственно в базу данных. Поэтому WQL по-прежнему соответствует вашей конфигурации доступа на основе ролей.

Запросы могут возвращать большинство типов объектов Configuration Manager, включая компьютеры, сайты, коллекции, приложения и данные инвентаризации. Дополнительные сведения см. в статье Общие сведения о запросах в Configuration Manager.

По умолчанию Configuration Manager включает несколько запросов. Для проверки запросов по умолчанию можно использовать командлет Get-CMQuery . Дополнительные примеры выражений WQL см. в разделе Примеры запросов WQL.

Примечание.

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

Примеры

Пример 1. Переименование запроса

Get-CMQuery -Name "My systems" | Set-CMQuery -NewName "My systems v2"

Пример 2. Изменение запроса, чтобы запросить ограничивающую коллекцию

Set-CMQuery -Name "Windows 10" -LimitToCollectionId "<Prompt>"

Параметры

-Comment

Укажите необязательный комментарий для дальнейшего определения запроса на сайте.

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

-Confirm

Перед запуском командлет запросит подтверждение.

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

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

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

-Expression

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

Инструкции WQL часто включают двойные кавычки ("), поэтому задайте значение этого параметра в виде строки, заключенной в одинарные кавычки (').

Дополнительные примеры см. в разделе Примеры запросов WQL.

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

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

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

-Id

Укажите идентификатор настраиваемого запроса. Например, "XYZ00006".

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

-InputObject

Укажите объект запроса для настройки. Чтобы получить этот объект, используйте командлет Get-CMQuery .

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

-LimitToCollectionId

Укажите, как настроить ограничение коллекции для этого запроса:

  • Не ограничивается коллекцией. Задайте для этого параметра значение пустой строки (""). Не используйте встроенную $null переменную.
  • Ограничение на коллекцию. Укажите идентификатор коллекции. Например, "SMSDM003" для коллекции Все клиенты рабочего стола и сервера .
  • Запрос на сбор. Задайте для этого параметра значение "<Prompt>".
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Укажите имя настраиваемого запроса.

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

-NewName

Укажите новое имя для переименования запроса.

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

-PassThru

Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.

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

-TargetClassName

Укажите имя класса объектов, возвращаемого запросом. Существует множество типов объектов. В следующей таблице перечислены несколько общих имен классов с описанием из консоли Configuration Manager:

Имя класса Описание
SMS_R_System Системный ресурс
SMS_Program Программа
SMS_R_UserGroup Ресурс группы пользователей
SMS_R_User Ресурс User
SMS_SiteAndSubsites Сайт и дочерние сайты
SMS_R_UnknownSystem Неизвестный компьютер
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object