{"content":"
","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/pt-br/powershell/","_op_gitContributorInformation":{"author":{"display_name":"Banreet Kaur","id":"92906285","name":"Banreet","profile_url":"https://github.com/Banreet"},"contributors":[{"display_name":"Aaron Czechowski","id":"26784733","name":"aczechowski","profile_url":"https://github.com/aczechowski"},{"display_name":"Dan Mabee","id":"40476441","name":"damabe","profile_url":"https://github.com/damabe"},{"display_name":"Jonathan Gao","id":"2213767","name":"mumian","profile_url":"https://github.com/mumian"},{"display_name":"sankethka","id":"16908144","name":"sankethka","profile_url":"https://github.com/sankethka"}],"update_at":"26/06/2026","updated_at_date_time":"2026-06-26T00:07:12.2458285Z"},"_path":"module/configurationmanager/set-cmquery.json","_rel":"../../","_tocRel":"../sccm-ps/toc.json","apiPlatform":"powershell","author":"Banreet","breadcrumb_path":"/powershell/sccm/bread/toc.json","canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/set-cmquery?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/Set-CMQuery.md","default_moniker":"sccm-ps","depot_name":"MSDN.sccm-powershell","description":"Configurar uma consulta do Configuration Manager.","document_id":"ab8427aa-8779-06dc-7dc9-4f55c34f9ff3","document_version_independent_id":"573297c4-9216-e4e3-9997-5928bcfb2941","external help file":"AdminUI.PS.dll-Help.xml","feedback_product_url":"https://feedbackportal.microsoft.com/feedback/forum/4669adfc-ee1b-ec11-b6e7-0022481f8472","feedback_system":"Standard","git_commit_id":"48cf632fb4b9ad92060012681a500478254de750","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/48cf632fb4b9ad92060012681a500478254de750/sccm-ps/ConfigurationManager/Set-CMQuery.md","github_contributors":["aczechowski","damabe","mumian","sankethka"],"locale":"pt-br","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"12/29/2020","ms.service":"configuration-manager","ms.subservice":"other","ms.topic":"reference","open_to_public_contributors":true,"original_content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/live/sccm-ps/ConfigurationManager/Set-CMQuery.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/Set-CMQuery.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","title":"Set-CMQuery","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-06-26 12:07 AM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/set-cmquery","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMQuery","schemaType":"PowershellCmdlet","summary":"

Configurar uma consulta do Configuration Manager.

\n","uid":"ConfigurationManager.Set-CMQuery"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Set-CMQuery":{"href":"set-cmquery","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMQuery","schemaType":"PowershellCmdlet","summary":"

Configurar uma consulta do Configuration Manager.

\n","uid":"ConfigurationManager.Set-CMQuery"}},"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.

\n

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.

\n

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.

\n
\n

Observação

\n

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.

\n
\n","examples":[{"code":"Get-CMQuery -Name \"My systems\" | Set-CMQuery -NewName \"My systems v2\"","description":"","summary":"","title":"Exemplo 1: Mudar o nome de uma consulta"},{"code":"Set-CMQuery -Name \"Windows 10\" -LimitToCollectionId \"\"","description":"","summary":"","title":"Exemplo 2: alterar a consulta para pedir uma coleção de limitação"}],"inputs":[{"description":"","name":"Microsoft.ConfigurationManagement.ManagementProvider.IResultObject\n"}],"links":[{"href":"export-cmquery","text":"Export-CMQuery"},{"href":"get-cmquery","text":"Get-CMQuery"},{"href":"import-cmquery","text":"Import-CMQuery"},{"href":"invoke-cmquery","text":"Invoke-CMQuery"},{"href":"new-cmquery","text":"New-CMQuery"},{"href":"remove-cmquery","text":"Remove-CMQuery"},{"href":"/mem/configmgr/core/servers/manage/introduction-to-queries","text":"Introdução às consultas no Configuration Manager"}],"module":"ConfigurationManager","name":"Set-CMQuery","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"

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

\n","name":"Comment","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"cf","defaultValue":"None","description":"

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

\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

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

\n

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

\n

Para obter mais exemplos, veja Exemplos de consultas WQL.

\n","name":"Expression","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"QueryId","defaultValue":"None","description":"

Especifique o ID da consulta a configurar. Por exemplo, "XYZ00006".

\n","isRequired":true,"name":"Id","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

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

\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"

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

\n\n","name":"LimitToCollectionId","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

Especifique o nome da consulta a configurar.

\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

Especifique um novo nome para mudar o nome da consulta.

\n","name":"NewName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

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.

\n","name":"PassThru","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

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:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Nome da classeDescrição
SMS_R_SystemRecurso do sistema
SMS_ProgramPrograma
SMS_R_UserGroupRecurso do grupo de utilizadores
SMS_R_UserRecurso de utilizador
SMS_SiteAndSubsitesSite e subsites
SMS_R_UnknownSystemComputador desconhecido
\n","name":"TargetClassName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"None","description":"

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

\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"

Configurar uma consulta do Configuration Manager.

\n","syntaxes":["Set-CMQuery [-Comment ] [-Expression ] -InputObject \n [-LimitToCollectionId ] [-NewName ] [-PassThru] [-TargetClassName ]\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] []","Set-CMQuery [-Comment ] [-Expression ] -Id [-LimitToCollectionId ]\n [-NewName ] [-PassThru] [-TargetClassName ] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] []","Set-CMQuery [-Comment ] [-Expression ] [-LimitToCollectionId ] -Name \n [-NewName ] [-PassThru] [-TargetClassName ] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] []"],"uid":"ConfigurationManager.Set-CMQuery","hideEdit":true,"ms.translationtype":"MT","ms.contentlocale":"pt-br","loc_version":"2024-08-21T21:18:36.7205003Z","loc_source_id":"Github-72476255#live","loc_file_id":"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/Set-CMQuery.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/set-cmquery","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMQuery","schemaType":"PowershellCmdlet","summary":"

Configurar uma consulta do Configuration Manager.

\n","uid":"ConfigurationManager.Set-CMQuery"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/set-cmquery?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/set-cmquery?view=sccm-ps"},"pageMetadata":"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.

\n

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.

\n

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.

\n
\n

Observação

\n

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.

\n
\n\" />\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\nConfigurar uma consulta do Configuration Manager.

\n\" />\r\n] [-Expression ] -InputObject \n [-LimitToCollectionId ] [-NewName ] [-PassThru] [-TargetClassName ]\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] []\" />\r\n] [-Expression ] -Id [-LimitToCollectionId ]\n [-NewName ] [-PassThru] [-TargetClassName ] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] []\" />\r\n] [-Expression ] [-LimitToCollectionId ] -Name \n [-NewName ] [-PassThru] [-TargetClassName ] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] []\" />\r\n\r\n","themesRelativePathToOutputRoot":"_themes/"}