Set-CMQuery

SYNOPSIS

Configurar uma consulta do Gestor de Configuração.

SYNTAX

SearchByValueMandatory (Padrão)

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

SearchByIdMandatory

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

PesquisaByNameMandatory

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

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

Exemplo 2: Alterar a consulta para solicitar uma cobrança limitativa

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

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

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: QueryId

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

-InputObject

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

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
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 para configurar.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-Novo Nome

Especifique um novo nome para renomear a consulta.

Type: String
Parameter Sets: (All)
Aliases:

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

- PassThru

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

RELATED LINKS

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