{"content":"
","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/it-it/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:15.1791432Z"},"_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/it-it/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":"Configurare una query di 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":"it-it","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":"

Configurare una query di 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":"

Configurare una query di Configuration Manager.

\n","uid":"ConfigurationManager.Set-CMQuery"}},"description":"

Usare questo cmdlet per configurare una query in Configuration Manager. Le query di Configuration Manager definiscono un'espressione WQL (WMI Query Language) per ottenere informazioni dal database del sito in base ai criteri specificati. WQL è simile a SQL, ma passa comunque attraverso il provider SMS anziché direttamente al database. WQL rimane quindi in base alla configurazione degli accessi in base al ruolo.

\n

Le query possono restituire la maggior parte dei tipi di oggetti di Configuration Manager, tra cui computer, siti, raccolte, applicazioni e dati di inventario. Per altre informazioni, vedere Introduzione alle query in Configuration Manager.

\n

Per impostazione predefinita, Configuration Manager include diverse query. È possibile usare il cmdlet Get-CMQuery per esaminare le query predefinite. Per altri esempi di espressioni WQL, vedere Query WQL di esempio.

\n
\n

Nota

\n

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\\>. Per altre informazioni, vedere Introduzione.

\n
\n","examples":[{"code":"Get-CMQuery -Name \"My systems\" | Set-CMQuery -NewName \"My systems v2\"","description":"","summary":"","title":"Esempio 1: Rinominare una query"},{"code":"Set-CMQuery -Name \"Windows 10\" -LimitToCollectionId \"\"","description":"","summary":"","title":"Esempio 2: Modificare la query per richiedere una raccolta di limitazione"}],"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":"Introduzione alle query in Configuration Manager"}],"module":"ConfigurationManager","name":"Set-CMQuery","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"

Specificare un commento facoltativo per identificare ulteriormente la query nel sito.

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

Richiede la conferma prima di eseguire il cmdlet.

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

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

Specificare l'istruzione WQL che definisce gli attributi da visualizzare nei risultati e i criteri per limitare i risultati.

\n

Le istruzioni WQL includono spesso virgolette doppie ("), quindi impostare il valore di questo parametro come stringa racchiusa tra virgolette singole (').

\n

Per altri esempi, vedere Query WQL di esempio.

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

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

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

Specificare l'ID della query da configurare. Ad esempio, "XYZ00006".

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

Specificare un oggetto query da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMQuery .

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

Specificare come configurare la limitazione della raccolta per questa query:

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

Specificare il nome della query da configurare.

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

Specificare un nuovo nome per rinominare la query.

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

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

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

Specificare il nome della classe oggetto che si desidera restituire la query. Sono disponibili molti tipi di oggetto. Nella tabella seguente sono elencati diversi nomi di classi comuni con la descrizione della console di 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 classeDescrizione
SMS_R_SystemRisorsa di sistema
SMS_ProgramProgramma
SMS_R_UserGroupRisorsa gruppo di utenti
SMS_R_UserRisorsa utente
SMS_SiteAndSubsitesSito e siti secondari
SMS_R_UnknownSystemComputer sconosciuto
\n","name":"TargetClassName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"None","description":"

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Configurare una query di 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":"it-it","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":"

Configurare una query di Configuration Manager.

\n","uid":"ConfigurationManager.Set-CMQuery"}],"canonical_url":"https://learn.microsoft.com/it-it/powershell/module/configurationmanager/set-cmquery?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/it-it/powershell/module/configurationmanager/set-cmquery?view=sccm-ps"},"pageMetadata":"Usare questo cmdlet per configurare una query in Configuration Manager. Le query di Configuration Manager definiscono un'espressione WQL (WMI Query Language) per ottenere informazioni dal database del sito in base ai criteri specificati. WQL è simile a SQL, ma passa comunque attraverso il provider SMS anziché direttamente al database. WQL rimane quindi in base alla configurazione degli accessi in base al ruolo.

\n

Le query possono restituire la maggior parte dei tipi di oggetti di Configuration Manager, tra cui computer, siti, raccolte, applicazioni e dati di inventario. Per altre informazioni, vedere Introduzione alle query in Configuration Manager.

\n

Per impostazione predefinita, Configuration Manager include diverse query. È possibile usare il cmdlet Get-CMQuery per esaminare le query predefinite. Per altri esempi di espressioni WQL, vedere Query WQL di esempio.

\n
\n

Nota

\n

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\\>. Per altre informazioni, vedere Introduzione.

\n
\n\" />\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\nConfigurare una query di 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/"}