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