Set-CMQuery
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