Partilhar via

New-CMQuery

  • Artigo

SYNOPSIS

Crie uma consulta do Gestor de Configuração.

SYNTAX

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

DESCRIPTION

Utilize este cmdlet para criar uma consulta no Gestor de Configurações.

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 o cmdlet Get-CMQuery para rever as consultas predefinidos. Para obter mais exemplos de expressões WQL, consulte as consultas de exemplo WQL.

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: Criar uma nova consulta para servidores de uma versão específica

Este exemplo cria uma nova consulta chamada Server 2016 que procura clientes com a legenda oss que começa com a Microsoft Windows Server 2012. Devolve as seguintes três propriedades: Nome, Último nome de utilizador de logon, e legenda do SISTEMA.

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 ambiente de trabalho

Este exemplo cria uma nova consulta chamada Dispositivos desktop que procura dispositivos com valores específicos para a propriedade dos tipos de Chassis da classe Desíduo do Sistema. Devolve várias propriedades, e é limitada 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"

PARAMETERS

-Comentário

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-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

-Expressão

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

As declarações WQL incluem frequentemente as aspas duplas ( " ), por isso, definir o valor deste parâmetro como uma corda incluída em aspas únicas ' ().

Para mais exemplos, consulte as consultas de exemplo WQL.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
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

-LimitToCollectionId

Especificar como configurar a coleta limitando para esta consulta:

  • Não a coleção limitada: Desabrar o valor deste parâmetro a uma corda em branco "" (). Não use a $null variável incorporada.
  • Limite à recolha: Especifique o ID de uma coleção. Por exemplo, "SMSDM003" para a coleção de Clientes de Todos os Desktop e Servidor.
  • Solicitação para recolha: Desa esta medida de valor para "<Prompt>" .
Type: String
Parameter Sets: (All)
Aliases:

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

-Name

Especifique o nome da consulta.

Type: String
Parameter Sets: (All)
Aliases:

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

-TargetClassName

Especifique o nome da classe de objeto que deseja que a consulta volte. Existem muitos tipos de objetos disponíveis. A tabela a seguir lista vários nomes de classes comuns com a descrição da consola Do Gestor de Configuração:

Nome da classe Description
SMS_R_System Recurso de sistema
SMS_Program Programa
SMS_R_UserGroup Recurso de grupo de utilizadores
SMS_R_User Recurso de utilizador
SMS_SiteAndSubsites Site e subsites
SMS_R_UnknownSystem Computador desconhecido 
Type: String
Parameter Sets: (All)
Aliases:

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

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

NOTAS

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