{"content":"
","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/ko-kr/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":"2026. 6. 26.","updated_at_date_time":"2026-06-26T00:07:19.797316Z"},"_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/ko-kr/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":"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":"ko-kr","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":"

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":"

Configuration Manager 쿼리를 구성합니다.

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

이 cmdlet을 사용하여 Configuration Manager에서 쿼리를 구성합니다. Configuration Manager 쿼리는 제공한 조건에 따라 사이트 데이터베이스에서 정보를 가져오는 WQL(WMI 쿼리 언어) 식을 정의합니다. WQL은 SQL과 비슷하지만 데이터베이스에 직접 연결하지 않고 SMS 공급자를 계속 통과합니다. 따라서 WQL은 여전히 역할 기반 액세스 구성을 준수합니다.

\n

쿼리는 컴퓨터, 사이트, 컬렉션, 애플리케이션 및 인벤토리 데이터를 포함하는 대부분의 유형의 Configuration Manager 개체를 반환할 수 있습니다. 자세한 내용은 Configuration Manager의 쿼리 소개를 참조하세요.

\n

기본적으로 Configuration Manager에는 여러 쿼리가 포함됩니다. \n Get-CMQuery cmdlet을 사용하여 기본 쿼리를 검토할 수 있습니다. WQL 식의 더 많은 예제는 예제 WQL 쿼리를 참조하세요.

\n
\n

참고

\n

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\\>). 자세한 내용은 시작을 참조하세요.

\n
\n","examples":[{"code":"Get-CMQuery -Name \"My systems\" | Set-CMQuery -NewName \"My systems v2\"","description":"","summary":"","title":"예제 1: 쿼리 이름 바꾸기"},{"code":"Set-CMQuery -Name \"Windows 10\" -LimitToCollectionId \"\"","description":"","summary":"","title":"예제 2: 제한 컬렉션을 묻는 메시지를 표시하도록 쿼리 변경"}],"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":"Configuration Manager의 쿼리 소개"}],"module":"ConfigurationManager","name":"Set-CMQuery","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"

선택적 주석을 지정하여 사이트에서 쿼리를 추가로 식별합니다.

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

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. \n ForceWildcardHandling과 결합할 수 없습니다.

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

결과에 표시할 특성과 결과를 제한하는 조건을 정의하는 WQL 문을 지정합니다.

\n

WQL 문에는 큰따옴표(")가 포함된 경우가 많으므로 이 매개 변수의 값을 작은따옴표(')로 묶은 문자열로 설정합니다.

\n

자세한 예제는 예제 WQL 쿼리를 참조하세요.

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

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. \n DisableWildcardHandling과 결합할 수 없습니다.

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

구성할 쿼리의 ID를 지정합니다. 예를 들면 "XYZ00006"와 같습니다.

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

구성할 쿼리 개체를 지정합니다. 이 개체를 얻으려면 Get-CMQuery cmdlet을 사용합니다.

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

이 쿼리에 대한 컬렉션 제한을 구성하는 방법을 지정합니다.

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

구성할 쿼리의 이름을 지정합니다.

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

쿼리 이름을 바꿀 새 이름을 지정합니다.

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

작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

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

쿼리를 반환할 개체 클래스의 이름을 지정합니다. 사용할 수 있는 개체 유형이 많이 있습니다. 다음 표에는 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
클래스 이름설명
SMS_R_System시스템 리소스
SMS_Program프로그램
SMS_R_UserGroup사용자 그룹 리소스
SMS_R_User사용자 리소스
SMS_SiteAndSubsites사이트 및 하위 사이트
SMS_R_UnknownSystem알 수 없는 컴퓨터
\n","name":"TargetClassName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"None","description":"

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

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

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":"ko-kr","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":"

Configuration Manager 쿼리를 구성합니다.

\n","uid":"ConfigurationManager.Set-CMQuery"}],"canonical_url":"https://learn.microsoft.com/ko-kr/powershell/module/configurationmanager/set-cmquery?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/ko-kr/powershell/module/configurationmanager/set-cmquery?view=sccm-ps"},"pageMetadata":"이 cmdlet을 사용하여 Configuration Manager에서 쿼리를 구성합니다. Configuration Manager 쿼리는 제공한 조건에 따라 사이트 데이터베이스에서 정보를 가져오는 WQL(WMI 쿼리 언어) 식을 정의합니다. WQL은 SQL과 비슷하지만 데이터베이스에 직접 연결하지 않고 SMS 공급자를 계속 통과합니다. 따라서 WQL은 여전히 역할 기반 액세스 구성을 준수합니다.

\n

쿼리는 컴퓨터, 사이트, 컬렉션, 애플리케이션 및 인벤토리 데이터를 포함하는 대부분의 유형의 Configuration Manager 개체를 반환할 수 있습니다. 자세한 내용은 Configuration Manager의 쿼리 소개를 참조하세요.

\n

기본적으로 Configuration Manager에는 여러 쿼리가 포함됩니다. \n Get-CMQuery cmdlet을 사용하여 기본 쿼리를 검토할 수 있습니다. WQL 식의 더 많은 예제는 예제 WQL 쿼리를 참조하세요.

\n
\n

참고

\n

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\\>). 자세한 내용은 시작을 참조하세요.

\n
\n\" />\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\nConfiguration 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/"}