{"content":"
","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/ja-jp/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/06/25","updated_at_date_time":"2026-06-25T23:24:20.6712319Z"},"_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/ja-jp/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":"レジストリ キー値の検出方法句を作成します。","document_id":"76ba55ff-2ec5-d636-9ff0-0253df752bb3","document_version_independent_id":"a462ec18-961f-38e1-11b6-c71d8024421f","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":"ja-jp","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-06-25 11:24 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":"

アプリケーションの検出方法で句を作成するには、このコマンドレットを使用します。 この句は、アプリケーションの存在を示すレジストリ キー値の規則です。

\n

値ではなくレジストリ キーの存在を検出するには、 New-CMDetectionClauseRegistryKey コマンドレットを 使用します。

\n

このコマンドレットを使用した後、展開の種類に 対して Add またはSet- のいずれかのコマンドレットを使用します。 この検出句オブジェクトを AddDetectionClause パラメーターまたは RemoveDetectionClause パラメーターに渡します。

\n

検出句をグループ化するには、デプロイの種類のコマンドレットで GroupDetectionClauses パラメーターを使用します。

\n
\n

注:

\n

\n PS XYZ:\\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

\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' |CurrentVersion の Select-Object

\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 を IsEquals に、 ExpectedValue を 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 パラメーターを追加する場合、レジストリ キーの値は、このアプリケーションの存在を示す規則を満たす必要があります。 このパラメーターは、 ExpectedValue、 ExpressionOperator、 PropertyType の各パラメーターと共に使用します。

\n

ルールを評価する代わりに、レジストリ キーの値が存在することを確認するには、 Exist パラメーターを使用します。

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

アプリケーションの存在を示すレジストリ キーの値を指定します。 \n Hive パラメーターを使用してレジストリ Hive を指定し、KeyName を使用してレジストリ キーを指定します。

\n

たとえば、次の PowerShell コマンドは、次のパラメーター値に変換します。

\n

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

\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":"ja-jp","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/ja-jp/powershell/module/configurationmanager/new-cmdetectionclauseregistrykeyvalue?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/ja-jp/powershell/module/configurationmanager/new-cmdetectionclauseregistrykeyvalue?view=sccm-ps"},"pageMetadata":"アプリケーションの検出方法で句を作成するには、このコマンドレットを使用します。 この句は、アプリケーションの存在を示すレジストリ キー値の規則です。

\n

値ではなくレジストリ キーの存在を検出するには、 New-CMDetectionClauseRegistryKey コマンドレットを 使用します。

\n

このコマンドレットを使用した後、展開の種類に 対して Add またはSet- のいずれかのコマンドレットを使用します。 この検出句オブジェクトを AddDetectionClause パラメーターまたは RemoveDetectionClause パラメーターに渡します。

\n

検出句をグループ化するには、デプロイの種類のコマンドレットで GroupDetectionClauses パラメーターを使用します。

\n
\n

注:

\n

\n PS XYZ:\\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

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