Partilhar via

Get-CMQuery

  • Artigo

SYNOPSIS

Obtenha uma consulta do Gestor de Configuração.

SYNTAX

ByName (Padrão)

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

ById

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

DESCRIPTION

Utilize este cmdlet para obter uma consulta no site do Gestor de Configuração. As consultas do Gestor de Configuração definem uma expressão WMI Query Language (WQL) para obter informações da base de dados do site com base nos critérios que fornece. O WQL é semelhante ao SQL, mas ainda passa pelo Fornecedor de SMS em vez de diretamente para a base de dados. Assim, o WQL ainda respeita a sua configuração de acesso baseada em funções.

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

Por predefinição, o Gestor de Configuração inclui várias consultas. Pode utilizar este cmdlet para rever as consultas predefinidos.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1

Este comando devolve todas as consultas com o nome "Clientes ConfigMgr".

Get-CMQuery -Name "*ConfigMgr clients *"

PARAMETERS

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

- ID

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

Type: String
Parameter Sets: ById
Aliases:

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

-Name

Especifique o nome da consulta para obter.

Pode utilizar caracteres wildcard:

  • *: Vários caracteres
  • ?: Personagem única
Type: String
Parameter Sets: ByName
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Nenhuma

OUTPUTS

IResultObject[]#SMS_Query

IResultObject#SMS_Query

NOTAS

Exportação-CMQuery Importação-CMQuery Invocar-CMQuery New-CMQuery Remover-CMQuery Set-CMQuery Introdução a consultas no Gestor de Configuração