Invoke-CMWmiQuery

Синтаксис

Invoke-CMWmiQuery
      [-Context <Hashtable>]
      [-Option <QueryOptions>]
      [-Query] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-CMWmiQuery
      -ClassName <String>
      [-Context <Hashtable>]
      [-Option <QueryOptions>]
      -Search <SmsProviderSearch>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Invoke-CMWmiQuery выполняет запрос инструментария управления Windows (WMI). В отличие от других командлетов запросов или средств, с помощью этого командлета подключение и пространство имен уже настроены для вас.

Этот командлет также можно использовать для создания запроса с использованием языка запросов WMI (WQL). Configuration Manager использует WQL для запросов в коллекциях. WQL похож на SQL, но по-прежнему использует поставщик SMS, поэтому соблюдает управление доступом на основе ролей.

Примеры

Пример 1. Выполнение WQL-запроса

Первая команда создает запрос WQL и сохраняет его в переменной $WQL . Вторая команда выполняет запрос, хранящийся в переменной.

$WQL = @"
SELECT app.* FROM SMS_ApplicationLatest AS app
INNER JOIN SMS_CIContentPackage AS con ON app.CI_ID=con.CI_ID
INNER JOIN SMS_DistributionPoint AS srv ON con.PackageID=srv.PackageID
WHERE app.IsHidden = 0
"@

Invoke-CMWmiQuery -Query $WQL -Option Lazy

Пример 2. Выполнение запроса WMI для коллекций устройств

Первая команда создает объект поиска и сохраняет его в переменной $Search .

Вторая команда указывает, что порядок поиска возрастает по CollectionID.

Третья команда добавляет параметры поиска в объект $Search . В этом случае запрос выполняет поиск коллекций устройств.

Последняя команда выполняет запрос, хранящийся в $Search. Он указывает SMS_Collection как класс, содержащий свойство CollectionID .

$Search = [Microsoft.ConfigurationManagement.PowerShell.Provider.SmsProviderSearch]::new()
$Search.AddOrder("CollectionID", [Microsoft.ConfigurationManagement.PowerShell.Provider.SearchParameterOrderBy]::Asc)
$Search.Add("Name","DeviceCol*", $True)

Invoke-CMWmiQuery -Search $Search -ClassName "SMS_Collection" -Option Lazy

Пример 3. Выполнение запроса WMI для сайтов по состоянию

Первая команда очищает параметры поиска из любого существующего объекта поиска.

Вторая команда добавляет параметры поиска в объект $Search . В этом случае запрос выполняет поиск сайтов.

Последняя команда выполняет запрос, хранящийся в $Search. Он указывает SMS_Site в качестве класса, содержащего свойство site Status .

$Search.Clear()
$Search.Add("Status", $True)

Invoke-CMWmiQuery -ClassName "SMS_Site" -Search $Search

Пример 4. Выполнение запроса WMI для сайтов по имени

Первая команда очищает параметры поиска из любого существующего объекта поиска.

Вторая команда добавляет параметры поиска в объект $Search . В этом случае запрос выполняет поиск сайтов.

Последняя команда выполняет запрос, хранящийся в $Search. Он указывает SMS_Site как класс, содержащий свойство SiteName .

$Search.Clear()
$Search.Add("SiteName", $null, [Microsoft.ConfigurationManagement.PowerShell.Provider.SearchParameterOperator]::NotEquals)

Invoke-CMWmiQuery -ClassName "SMS_Site" -Search $Search

Пример 5. Выполнение запроса WMI для приложений

Первая команда очищает параметры поиска из любого существующего объекта поиска.

Вторая команда добавляет параметры поиска в объект $Search . В этом случае запрос ищет приложения.

Последняя команда выполняет запрос, хранящийся в $Search. Он указывает SMS_Application как класс, содержащий свойство site CI_ID .

$Search.Clear()
$Search.AddAdhoc("CI_ID > 0")

Invoke-CMWmiQuery -ClassName "SMS_Application" -Search $Search -Option Lazy

Параметры

-ClassName

-Confirm

-Context

-DisableWildcardHandling

-ForceWildcardHandling

-Option

-Query

-Search

-WhatIf

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

None

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

IResultObject[]

IResultObject

Связанные ссылки

• Invoke-CMWmiMethod