{"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":"sankethka","id":"16908144","name":"sankethka","profile_url":"https://github.com/sankethka"}],"update_at":"2026. 9. 1.","updated_at_date_time":"2026-09-01T12:08:41.1267973Z"},"_path":"module/configurationmanager/new-cmdetectionclauseregistrykeyvalue.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/new-cmdetectionclauseregistrykeyvalue?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/New-CMDetectionClauseRegistryKeyValue.md","default_moniker":"sccm-ps","depot_name":"MSDN.sccm-powershell","description":"레지스트리 키 값에 대한 검색 방법 절을 만듭니다.","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":"c74b3f4574af7a8a480adb998b311f6eeeb3e856","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/c74b3f4574af7a8a480adb998b311f6eeeb3e856/sccm-ps/ConfigurationManager/New-CMDetectionClauseRegistryKeyValue.md","github_contributors":["aczechowski","damabe","sankethka"],"locale":"ko-kr","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"08/26/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/New-CMDetectionClauseRegistryKeyValue.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/New-CMDetectionClauseRegistryKeyValue.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","title":"New-CMDetectionClauseRegistryKeyValue","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-09-01 12:08 PM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmdetectionclauseregistrykeyvalue","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMDetectionClauseRegistryKeyValue","schemaType":"PowershellCmdlet","summary":"

레지스트리 키 값에 대한 검색 방법 절을 만듭니다.

\n","uid":"ConfigurationManager.New-CMDetectionClauseRegistryKeyValue"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMDetectionClauseRegistryKeyValue":{"href":"new-cmdetectionclauseregistrykeyvalue","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMDetectionClauseRegistryKeyValue","schemaType":"PowershellCmdlet","summary":"

레지스트리 키 값에 대한 검색 방법 절을 만듭니다.

\n","uid":"ConfigurationManager.New-CMDetectionClauseRegistryKeyValue"}},"description":"

이 cmdlet을 사용하여 애플리케이션의 검색 메서드에 절을 만듭니다. 이 절은 애플리케이션의 존재를 나타내는 레지스트리 키 값에 대한 규칙입니다.

\n

값 대신 레지스트리 키가 있는지 감지하려면 New-CMDetectionClauseRegistryKey cmdlet을 사용합니다.

\n

이 cmdlet을 사용한 후 배포 유형에 추가 또는Set- cmdlet 중 하나를 사용합니다. 이 검색 절 개체를 AddDetectionClause 또는 RemoveDetectionClause 매개 변수에 전달합니다.

\n

검색 절을 그룹화하려면 배포 유형 cmdlet에서 GroupDetectionClauses 매개 변수를 사용합니다.

\n
\n

참고

\n

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

\n
\n","examples":[{"code":"$regClause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName \"SOFTWARE\\GitForWindows\" -PropertyType String -ValueName \"CurrentVersion\" -Existence\n\nSet-CMMsiDeploymentType -ApplicationName \"Git for Windows\" -DeploymentTypeName \"Install\" -AddDetectionClause $regClause","description":"","summary":"

이 예제에서는 Windows용 Git 현재 버전 값의 존재를 검색하는 절을 만듭니다.

\n","title":"예제 1: 레지스트리 값의 존재 검색"},{"code":"$clause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName 'Software\\Microsoft\\Office\\ClickToRun\\Configuration' -PropertyType Version -ValueName 'VersionToReport' -Value -ExpectedValue '16.0.10730.20304' -ExpressionOperator GreaterEquals\n\nSet-CMMsiDeploymentType -ApplicationName \"Microsoft 365\" -DeploymentTypeName \"Install\" -AddDetectionClause $clause","description":"","summary":"

이 예제에서는 레지스트리의 Microsoft 365 버전을 보다 크거나 같게 비교하는 절을 16.0.10730.20304만듭니다.

\n","title":"예제 2: 레지스트리의 버전 값 비교"}],"inputs":[{"description":"","name":"None\n"}],"links":[{"href":"new-cmdetectionclausedirectory","text":"New-CMDetectionClauseDirectory"},{"href":"new-cmdetectionclausefile","text":"New-CMDetectionClauseFile"},{"href":"new-cmdetectionclauseregistrykey","text":"New-CMDetectionClauseRegistryKey"},{"href":"new-cmdetectionclausewindowsinstaller","text":"New-CMDetectionClauseWindowsInstaller"}],"module":"ConfigurationManager","name":"New-CMDetectionClauseRegistryKeyValue","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"

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

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

이 매개 변수를 추가하면 이 애플리케이션의 존재를 나타내려면 레지스트리 키 값이 대상 시스템에 있어야 합니다.

\n

단순히 존재하는 대신 이 레지스트리 키 값의 데이터에 대한 규칙을 평가하려면 Value 매개 변수를 사용합니다.

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

\n Value 매개 변수를 추가하면 PropertyType 및 ExpressionOperator와 함께 ExpectedValue를 사용합니다. 이러한 매개 변수를 사용하는 경우 레지스트리 키 값은 이 애플리케이션의 존재를 나타내는 규칙을 충족해야 합니다. 이 ExpectedValue 매개 변수는 레지스트리 키 값과 비교할 값을 지정합니다.

\n

비교할 값은 지정된 PropertyType에 따라 달라집니다.

\n","isRequired":true,"name":"ExpectedValue","parameterValueGroup":"","position":"Named","type":"

String[]

\n"},{"aliases":"","defaultValue":"None","description":"

\n Value 매개 변수를 추가하면 PropertyType 및 ExpectedValue와 함께 ExpressionOperator를 사용합니다. 이러한 매개 변수를 사용하는 경우 레지스트리 키 값은 이 애플리케이션의 존재를 나타내는 규칙을 충족해야 합니다. 이 ExpressionOperator 매개 변수는 레지스트리 키 값을 예상 값과 비교할 연산자를 지정합니다.

\n

버전 2010부터 매개 변수 형식이 RuleExpressionOperator 에서 RegistryValueRuleExpressionOperator로 변경되었습니다.

\n","isRequired":true,"name":"ExpressionOperator","parameterValueGroup":"IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf, BeginsWith, NotBeginsWith, EndsWith, NotEndsWith, Contains, NotContains","position":"Named","type":"RegistryValueRuleExpressionOperator\n"},{"aliases":"","defaultValue":"None","description":"

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

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

키가 있는 레지스트리 하이브를 지정합니다. \n KeyName 매개 변수를 사용하여 키 이름을 지정합니다. \n ValueName 매개 변수를 사용하여 레지스트리 키 값을 지정합니다.

\n

예를 들어 다음 PowerShell 명령은 다음 매개 변수 값으로 변환됩니다.

\n

Get-ItemProperty 'HKLM:\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | Select-Object CurrentVersion

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
매개 변수값
\n HiveLocalMachine
\n KeyName'SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'
\n ValueNameCurrentVersion
\n","isRequired":true,"name":"Hive","parameterValueGroup":"ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users","position":"Named","type":"RegistryRootKey\n"},{"aliases":"","defaultValue":"None","description":"

이 레지스트리 키가 64비트 시스템의 32비트 애플리케이션과 연결되어 있음을 나타내려면 이 매개 변수를 추가합니다.

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

이 애플리케이션의 존재를 나타내기 위해 존재해야 하는 레지스트리 키의 이름을 지정합니다. \n Hive 매개 변수를 사용하여 이 키가 있어야 하는 레지스트리 하이브를 지정합니다. \n ValueName 매개 변수를 사용하여 레지스트리 키 값을 지정합니다.

\n

예를 들어 다음 PowerShell 명령은 다음 매개 변수 값으로 변환됩니다.

\n

Get-ItemProperty 'HKLM:\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | Select-Object CurrentVersion

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
매개 변수값
\n HiveLocalMachine
\n KeyName'SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'
\n ValueNameCurrentVersion
\n","isRequired":true,"name":"KeyName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

\n Value 매개 변수를 추가하면 ExpressionOperator 및 ExpectedValue와 함께 PropertyType을 사용합니다. 이러한 매개 변수를 사용하는 경우 레지스트리 키 값은 이 애플리케이션의 존재를 나타내는 규칙을 충족해야 합니다. 이 PropertyType 매개 변수는 레지스트리 키 값의 데이터 형식을 지정합니다.

\n

예를 들어 이 매개 변수를 로 Version설정하고 ExpressionOperator를 로 설정하고 ExpectedValue를 IsEquals로 1.48.1.0설정합니다. 그런 다음 규칙은 지정된 레지스트리 키 값을 확인하여 동일한 버전을 갖도록 합니다.

\n","isRequired":true,"name":"PropertyType","parameterValueGroup":"Version, Integer, String","position":"Named","type":"SettingDataType\n"},{"aliases":"ValueRule","defaultValue":"None","description":"

\n Value 매개 변수를 추가할 때 레지스트리 키 값은 이 애플리케이션의 존재를 나타내는 규칙을 충족해야 합니다. \n ExpectedValue, ExpressionOperator 및 PropertyType 매개 변수와 함께 이 매개 변수를 사용합니다.

\n

규칙을 평가하는 대신 레지스트리 키 값이 있는지 확인하려면 Exist 매개 변수를 사용합니다.

\n","isRequired":true,"name":"Value","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"RegistryValueName","defaultValue":"None","description":"

애플리케이션의 존재를 나타내는 레지스트리 키 값을 지정합니다. \n Hive 매개 변수를 사용하여 레지스트리 하이브를 지정하고 KeyName을 사용하여 레지스트리 키를 지정합니다.

\n

예를 들어 다음 PowerShell 명령은 다음 매개 변수 값으로 변환됩니다.

\n

Get-ItemProperty 'HKLM:\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | Select-Object CurrentVersion

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
매개 변수값
\n HiveLocalMachine
\n KeyName'SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'
\n ValueNameCurrentVersion
\n","isRequired":true,"name":"ValueName","parameterValueGroup":"","position":"Named","type":"String\n"}],"schema":"PowershellCmdlet","summary":"

레지스트리 키 값에 대한 검색 방법 절을 만듭니다.

\n","syntaxes":["New-CMDetectionClauseRegistryKeyValue -ExpressionOperator \n -Hive [-Is64Bit] -KeyName -PropertyType -ValueName \n -ExpectedValue [-Value] [-DisableWildcardHandling] [-ForceWildcardHandling] []","New-CMDetectionClauseRegistryKeyValue -Hive [-Is64Bit] -KeyName \n -PropertyType -ValueName [-Existence] [-DisableWildcardHandling]\n [-ForceWildcardHandling] []"],"uid":"ConfigurationManager.New-CMDetectionClauseRegistryKeyValue","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/New-CMDetectionClauseRegistryKeyValue.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmdetectionclauseregistrykeyvalue","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMDetectionClauseRegistryKeyValue","schemaType":"PowershellCmdlet","summary":"

레지스트리 키 값에 대한 검색 방법 절을 만듭니다.

\n","uid":"ConfigurationManager.New-CMDetectionClauseRegistryKeyValue"}],"canonical_url":"https://learn.microsoft.com/ko-kr/powershell/module/configurationmanager/new-cmdetectionclauseregistrykeyvalue?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/ko-kr/powershell/module/configurationmanager/new-cmdetectionclauseregistrykeyvalue?view=sccm-ps"},"pageMetadata":"이 cmdlet을 사용하여 애플리케이션의 검색 메서드에 절을 만듭니다. 이 절은 애플리케이션의 존재를 나타내는 레지스트리 키 값에 대한 규칙입니다.

\n

값 대신 레지스트리 키가 있는지 감지하려면 New-CMDetectionClauseRegistryKey cmdlet을 사용합니다.

\n

이 cmdlet을 사용한 후 배포 유형에 추가 또는Set- cmdlet 중 하나를 사용합니다. 이 검색 절 개체를 AddDetectionClause 또는 RemoveDetectionClause 매개 변수에 전달합니다.

\n

검색 절을 그룹화하려면 배포 유형 cmdlet에서 GroupDetectionClauses 매개 변수를 사용합니다.

\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\n레지스트리 키 값에 대한 검색 방법 절을 만듭니다.

\n\" />\r\n\n -Hive [-Is64Bit] -KeyName -PropertyType -ValueName \n -ExpectedValue [-Value] [-DisableWildcardHandling] [-ForceWildcardHandling] []\" />\r\n [-Is64Bit] -KeyName \n -PropertyType -ValueName [-Existence] [-DisableWildcardHandling]\n [-ForceWildcardHandling] []\" />\r\n\r\n","themesRelativePathToOutputRoot":"_themes/"}