Get-CMQuery

  • Referência
Módulo:
ConfigurationManager

Obter uma consulta do Configuration Manager.

Sintaxe

Get-CMQuery
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMQuery
   [-Id <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilize este cmdlet para obter uma consulta a partir do site do Configuration Manager. As consultas do Configuration Manager definem uma expressão WMI Query Language (WQL) para obter informações da base de dados do site com base nos critérios que fornecer. O WQL é semelhante ao SQL, mas continua a passar pelo Fornecedor de SMS em vez de diretamente para a base de dados. Assim, o WQL continua a respeitar a configuração de acesso baseado em funções.

As consultas podem devolver a maioria dos tipos de objetos do Configuration Manager, que incluem computadores, sites, coleções, aplicações e dados de inventário. Para obter mais informações, veja Introdução às consultas no Configuration Manager.

Por predefinição, o Configuration Manager inclui várias consultas. Pode utilizar este cmdlet para rever as consultas predefinidas.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1

Este comando devolve todas as consultas com o nome que contém "Clientes do ConfigMgr".

Get-CMQuery -Name "*ConfigMgr clients *"

Parâmetros

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifique o ID da consulta a obter. Por exemplo, "XYZ00006".

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique o nome da consulta a obter.

Pode utilizar carateres universais:

  • *: Múltiplos carateres
  • ?: caráter único
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

Entradas

None

Saídas

IResultObject[]

IResultObject