Set-CMQuery

  • Referência
Módulo:
ConfigurationManager

Configurar uma consulta do Configuration Manager.

Sintaxe

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

Utilize este cmdlet para configurar uma consulta no 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 o cmdlet Get-CMQuery para rever as consultas predefinidas. Para obter mais exemplos de expressões WQL, veja Exemplo de consultas WQL.

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: Mudar o nome de uma consulta

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

Exemplo 2: alterar a consulta para pedir uma coleção de limitação

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

Parâmetros

-Comment

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

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

-Confirm

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

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

-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

-Expression

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

Muitas vezes, as instruções WQL incluem aspas duplas ("), por isso defina o valor deste parâmetro como uma cadeia entre aspas simples (').

Para obter mais exemplos, veja Exemplos de consultas WQL.

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

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

-InputObject

Especifique um objeto de consulta a configurar. Para obter este objeto, utilize o cmdlet Get-CMQuery .

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

-LimitToCollectionId

Especifique como configurar a limitação da coleção para esta consulta:

  • Não limitado à coleção: defina o valor deste parâmetro como uma cadeia em branco (""). Não utilize a $null variável incorporada.
  • Limite à coleção: especifique o ID de uma coleção. Por exemplo, "SMSDM003" para a coleção Todos os Clientes de Ambiente de Trabalho e Servidor .
  • Pedido de recolha: defina o valor deste parâmetro como "<Prompt>".
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 configurar.

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

-NewName

Especifique um novo nome para mudar o nome da consulta.

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

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

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

-TargetClassName

Especifique o nome da classe de objeto que pretende que a consulta devolva. Existem muitos tipos de objeto disponíveis. A tabela seguinte lista vários nomes de classe comuns com a descrição da consola do Configuration Manager:

Nome da classe Descrição
SMS_R_System Recurso do sistema
SMS_Program Programa
SMS_R_UserGroup Recurso do grupo de utilizadores
SMS_R_User Recurso de utilizador
SMS_SiteAndSubsites Site e subsites
SMS_R_UnknownSystem Computador desconhecido
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object