Share via


Get-CMQuery

Obter uma consulta do Configuration Manager.

Syntax

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

Description

Use este cmdlet para obter uma consulta do site do Configuration Manager. As consultas do Configuration Manager definem uma expressão WQL (WQL) para obter informações do banco de dados do site com base nos critérios que você fornece. O WQL é semelhante ao SQL, mas ainda passa pelo Provedor de SMS em vez de diretamente para o banco de dados. Portanto, o WQL ainda respeita a configuração de acesso baseado em função.

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

Por padrão, o Configuration Manager inclui várias consultas. Você pode usar esse cmdlet para revisar as consultas padrão.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1

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

Get-CMQuery -Name "*ConfigMgr clients *"

Parâmetros

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique o nome da consulta a ser consultada.

Você pode usar caracteres curinga:

  • *: Vários caracteres
  • ?: Caractere único
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

Entradas

Nenhum

Saídas

IResultObject[]

IResultObject