Share via

Set-CMQuery

  • Referência
Módulo:
ConfigurationManager

Configure uma consulta do Configuration Manager.

Syntax

Set-CMQuery
   [-Comment <String>]
   [-Expression <String>]
   -InputObject <IResultObject>
   [-LimitToCollectionId <String>]
   [-NewName <String>]
   [-PassThru]
   [-TargetClassName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMQuery
   [-Comment <String>]
   [-Expression <String>]
   -Id <String>
   [-LimitToCollectionId <String>]
   [-NewName <String>]
   [-PassThru]
   [-TargetClassName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMQuery
   [-Comment <String>]
   [-Expression <String>]
   [-LimitToCollectionId <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-TargetClassName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para configurar uma consulta no 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 o cmdlet Get-CMQuery para revisar as consultas padrão. Para obter mais exemplos de expressões WQL, consulte Example WQL queries.

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: Renomear uma consulta

Get-CMQuery -Name "My systems" | Set-CMQuery -NewName "My systems v2"

Exemplo 2: Alterar a consulta para solicitar uma coleção limitante

Set-CMQuery -Name "Windows 10" -LimitToCollectionId "<Prompt>"

Parâmetros

-Comentário

Especifique um comentário opcional para identificar ainda mais a consulta no site.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-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

-Expression

Especifique a instrução WQL que define os atributos a ser exibidos nos resultados e os critérios para limitar os resultados.

As instruções WQL geralmente incluem aspas duplas ( ), portanto, defina o valor desse parâmetro como uma cadeia de caracteres entre aspas " simples ( ' ).

Para obter mais exemplos, consulte Example WQL queries.

Type:String
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 configurada. Por exemplo, "XYZ00006".

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

-InputObject

Especifique um objeto de consulta a ser configurar. Para obter esse objeto, use o cmdlet Get-CMQuery.

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

-LimitToCollectionId

Especifique como configurar o limite de coleção para esta consulta:

  • Não limitado à coleção: de definir o valor desse parâmetro como uma cadeia de caracteres em branco ( "" ). Não use a $null variável embutida.
  • Limite para coleção: Especifique a ID de uma coleção. Por exemplo, "SMSDM003" para a coleção Todos os Clientes de Desktop e Servidor.
  • Prompt for collection: De definir o valor desse parâmetro como "<Prompt>" .
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique o nome da consulta a ser configurada.

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

-NewName

Especifique um novo nome para renomear a consulta.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-TargetClassName

Especifique o nome da classe de objeto que você deseja que a consulta retorne. Há muitos tipos de objeto disponíveis. A tabela a seguir lista vários nomes de classe comuns com a descrição do console do Configuration Manager:

Nome da classe Descrição
SMS_R_System Recurso System
SMS_Program Programa
SMS_R_UserGroup Recurso de grupo de usuários
SMS_R_User Recurso user
SMS_SiteAndSubsites Site e subsites
SMS_R_UnknownSystem Computador desconhecido
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object