New-CMDetectionClauseRegistryKey
建立登錄機碼的偵測方法子句。
語法
New-CMDetectionClauseRegistryKey
[-Existence]
-Hive <RegistryRootKey>
[-Is64Bit]
-KeyName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Description
使用此 Cmdlet 在應用程式的偵測方法中建立 子句。 這個子句是登錄機碼的規則,用來指出應用程式是否存在。
若要偵測登錄值而非機碼,請使用 New-CMDetectionClauseRegistryKeyValue Cmdlet。
使用此 Cmdlet 之後,請針對部署類型使用其中一個 Add- 或 Set- Cmdlet。 將此偵測子句對象傳遞至 AddDetectionClause 或 RemoveDetectionClause 參數。
若要將偵測子句分組,請在部署類型 Cmdlet 上使用 GroupDetectionClauses 參數。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:建立 MSI 應用程式部署類型的多個子句
此範例會建立兩個檔案子句和一個登錄子句,然後使用它們將 MSI 部署類型新增至應用程式。
$cla1=New-CMDetectionClauseFile -FileName "filetest" -PropertyType Size -ExpectedValue 123 -ExpressionOperator IsEquals -Path "C:\" -Value -Is64Bit
$cla2=New-CMDetectionClauseFile -FileName "foldertest" -PropertyType DateCreated -ExpectedValue (Get-Date) -ExpressionOperator LessThan -Path "C:\" -Value
$cla3=New-CMDetectionClauseRegistryKey -Hive ClassesRoot -KeyName "aaa"
$logic1=$cla1.Setting.LogicalName
$logic2=$cla2.Setting.LogicalName
$logic3=$cla3.Setting.LogicalName
Add-CMMsiDeploymentType -AddDetectionClause $cla1,$cla2,$cla3 -ApplicationName "app" -DeploymentTypeName "dt" -InstallCommand "mycommand" -ContentLocation "\\server\sources\Orca.msi" -GroupDetectionClauses $logic1,$logic2 -DetectionClauseConnector {LogicalName=$logic2;Connector="or"},{LogicalName=$logic3;Connector="or"}
參數
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Existence
此參數為隱含且選擇性。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Hive
指定機碼所在的登錄區。 使用 KeyName 參數來指定金鑰名稱。
類型: | RegistryRootKey |
別名: | RegistryHive |
接受的值: | ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Is64Bit
新增此參數,表示此登錄機碼與64位系統上的32位應用程式相關聯。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-KeyName
指定必須存在的登錄機碼名稱,以指出此應用程式是否存在。 使用 Hive 參數來指定應存在此金鑰的登錄區。
類型: | String |
別名: | RegistryKey |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
System.Object