Share via

New-CMQuery

  • Referência
Módulo:
ConfigurationManager

Crie uma consulta Configuration Manager.

Syntax

New-CMQuery
   [-Comment <String>]
   -Expression <String>
   [-LimitToCollectionId <String>]
   -Name <String>
   [-TargetClassName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use esse cmdlet para criar uma consulta no Configuration Manager.

Configuration Manager consultas definem uma expressão WQL (WMI Query Language) para obter informações do banco de dados do site com base nos critérios fornecidos. 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 sua configuração de acesso baseada em função.

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

Por padrão, Configuration Manager inclui várias consultas. Você pode usar o cmdlet Get-CMQuery para examinar as consultas padrão. Para obter mais exemplos de expressões WQL, consulte Consultas WQL de exemplo.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: criar uma nova consulta para servidores de uma versão específica

Este exemplo cria uma nova consulta chamada Server 2016 que pesquisa clientes com a legenda do sistema operacional que começa com o Microsoft Windows Server 2012. Ele retorna as três propriedades a seguir: Nome, Sobrenome nome de usuário e legenda do sistema operacional.

New-CMQuery -Name "Server 2016" -Expression 'select SMS_R_System.Name, SMS_R_System.LastLogonUserName, SMS_G_System_OPERATING_SYSTEM.Caption from SMS_R_System inner join SMS_G_System_OPERATING_SYSTEM on SMS_G_System_OPERATING_SYSTEM.ResourceID = SMS_R_System.ResourceId where SMS_G_System_OPERATING_SYSTEM.Caption like "Microsoft Windows Server 2012%"' -TargetClassName "SMS_R_System" -LimitToCollectionId "SMS00001"

Exemplo 2: criar uma consulta para dispositivos de área de trabalho

Este exemplo cria uma nova consulta chamada Dispositivos desktop que pesquisa dispositivos com valores específicos para a propriedade tipos de chassi da classe System Enclosure . Ele retorna várias propriedades e é limitado por uma coleção específica.

New-CMQuery -Name "Desktop devices" -Expression 'select SMS_R_SYSTEM.ResourceID,SMS_R_SYSTEM.ResourceType,SMS_R_SYSTEM.Name,SMS_R_SYSTEM.SMSUniqueIdentifier,SMS_R_SYSTEM.ResourceDomainORWorkgroup,SMS_R_SYSTEM.Client from SMS_R_System inner join SMS_G_System_SYSTEM_ENCLOSURE on SMS_G_System_SYSTEM_ENCLOSURE.ResourceID = SMS_R_System.ResourceId where SMS_G_System_SYSTEM_ENCLOSURE.ChassisTypes in ( "3", "4", "5","6", "7", "15","16")' -TargetClassName "SMS_R_System" -LimitToCollectionId "XYZ000049"

Parâmetros

-Comment

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

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-Expression

Especifique a instrução WQL que define os atributos a serem 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 (').

Para obter mais exemplos, confira Exemplo de consultas WQL.

Type:String
Position:Named
Default value:None
Required:True
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). Você não pode combiná-lo com DisableWildcardHandling.

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

-LimitToCollectionId

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

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

-Name

Especifique o nome da consulta.

Type:String
Position:Named
Default value:None
Required:True
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 Configuration Manager:

Nome da classe Descrição
SMS_R_System Recurso do sistema
SMS_Program Programa
SMS_R_UserGroup Recurso de grupo de usuários
SMS_R_User Recurso de usuário
SMS_SiteAndSubsites Sites e subsites
SMS_R_UnknownSystem Computador desconhecido
Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

IResultObject