Creare una query di Configuration Manager.
\n","uid":"ConfigurationManager.New-CMQuery"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMQuery":{"href":"new-cmquery","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMQuery","schemaType":"PowershellCmdlet","summary":"Creare una query di Configuration Manager.
\n","uid":"ConfigurationManager.New-CMQuery"}},"description":"Usare questo cmdlet per creare una query in Configuration Manager.
\nLe 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.
\nLe 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.
\nPer 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.
\nNota
\nEseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\\>. Per altre informazioni, vedere Introduzione.
In questo esempio viene creata una nuova query denominata Server 2016 che cerca i client con la didascalia del sistema operativo che inizia con Microsoft Windows Server 2012. Restituisce le tre proprietà seguenti: Nome, Cognome utente di accesso e didascalia del sistema operativo.
\n","title":"Esempio 1: Creare una nuova query per i server di una versione specifica"},{"code":"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\"","description":"","summary":"In questo esempio viene creata una nuova query denominata Dispositivi desktop che cerca i dispositivi con valori specifici per la proprietà Tipi chassis della classe System Enclosure . Restituisce più proprietà ed è limitata da una raccolta specifica.
\n","title":"Esempio 2: Creare una query per i dispositivi desktop"}],"inputs":[{"description":"","name":"None\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":"remove-cmquery","text":"Remove-CMQuery"},{"href":"set-cmquery","text":"Set-CMQuery"},{"href":"/mem/configmgr/core/servers/manage/introduction-to-queries","text":"Introduzione alle query in Configuration Manager"}],"module":"ConfigurationManager","name":"New-CMQuery","notes":"","outputs":[{"description":"","name":"IResultObject\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.
\nLe istruzioni WQL includono spesso virgolette doppie ("), quindi impostare il valore di questo parametro come stringa racchiusa tra virgolette singole (').
Per altri esempi, vedere Query WQL di esempio.
\n","isRequired":true,"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":"","defaultValue":"None","description":"Specificare come configurare la limitazione della raccolta per questa query:
\n""). Non usare la $null variabile predefinita."SMSDM003" per la raccolta Tutti i client desktop e server ."<Prompt>".Specificare il nome della query.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"String\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| Nome classe | \nDescrizione | \n
|---|---|
SMS_R_System | \nRisorsa di sistema | \n
SMS_Program | \nProgramma | \n
SMS_R_UserGroup | \nRisorsa gruppo di utenti | \n
SMS_R_User | \nRisorsa utente | \n
SMS_SiteAndSubsites | \nSito e siti secondari | \n
SMS_R_UnknownSystem | \nComputer sconosciuto | \n
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":"Creare una query di Configuration Manager.
\n","syntaxes":["New-CMQuery [-CommentCreare una query di Configuration Manager.
\n","uid":"ConfigurationManager.New-CMQuery"}],"canonical_url":"https://learn.microsoft.com/it-it/powershell/module/configurationmanager/new-cmquery?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/it-it/powershell/module/configurationmanager/new-cmquery?view=sccm-ps"},"pageMetadata":"Usare questo cmdlet per creare una query in Configuration Manager.\nLe 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.
\nLe 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.
\nPer 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.
\nNota
\nEseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\\>. Per altre informazioni, vedere Introduzione.