New-CMDetectionClauseWindowsInstaller
建立 MSI 產品代碼的偵測方法子句。
語法
New-CMDetectionClauseWindowsInstaller
-ExpectedValue <String>
-ExpressionOperator <WindowsInstallerRuleExpressionOperator>
-ProductCode <Guid>
[-PropertyType <MSIProperty>]
[-Value]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] New-CMDetectionClauseWindowsInstaller
-ProductCode <Guid>
[-Existence]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Description
使用此 Cmdlet 在應用程式的偵測方法中建立 子句。 此子句是 Windows Installer (MSI) 產品程式代碼的規則，指出應用程式是否存在。
使用此 Cmdlet 之後，請針對部署類型使用其中一個 Add- 或 Set- Cmdlet。 將此偵測子句對象傳遞至 AddDetectionClause 或 RemoveDetectionClause 參數。
若要將偵測子句分組，請在部署類型 Cmdlet 上使用 GroupDetectionClauses 參數。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：偵測 MSI 產品程式代碼是否存在
本範例會將 Configuration Manager 控制台 MSI 產品程式代碼新增至部署類型。
$clause = New-CMDetectionClauseWindowsInstaller -Existence -ProductCode 4F7840A9-9816-45E2-9F6C-F7067A8BC0FD
Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause參數
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Existence
當您新增此參數時，MSI 產品代碼必須存在於目標系統上，以指出此應用程式是否存在。
若要評估版本條件，請使用 Value 參數，而不只是存在。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ExpectedValue
當您新增 Value 參數時，請使用 ExpectedValue 搭配 PropertyType 和 ExpressionOperator。 當您使用這些參數時，MSI 版本必須滿足規則，以指出此應用程式是否存在。 這個 ExpectedValue 參數會指定要與裝置比較的值。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ExpressionOperator
當您新增 Value 參數時，請搭配 PropertyType 和 ExpectedValue 使用 ExpressionOperator。 當您使用這些參數時，MSI 版本必須滿足規則，以指出此應用程式是否存在。 這個 ExpressionOperator 參數會指定要比較裝置值與預期值的運算符。
從 2010 版開始，參數類型從 RuleExpressionOperator 變更為 WindowsInstallerRuleExpressionOperator。
| 類型: | WindowsInstallerRuleExpressionOperator |
| 接受的值: | IsEquals, NotEquals, GreaterThan, LessThan, GreaterEquals, LessEquals |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ProductCode
指定指出此應用程式存在的 Windows Installer 產品代碼。 格式為 GUID， 例如 4F7840A9-9816-45E2-9F6C-F7067A8BC0FD。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PropertyType
當您新增 Value 參數時，請搭配 ExpressionOperator 和 ExpectedValue 使用 PropertyType。 當您使用這些參數時，MSI 版本必須滿足規則，以指出此應用程式是否存在。
這個 PropertyType 參數目前僅支援單一值 ProductVersion
| 類型: | MSIProperty |
| 接受的值: | ProductVersion |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Value
當您新增 Value 參數以及產品程式代碼時，MSI 版本也必須滿足規則，以指出此應用程式是否存在。 使用此參數搭配下列參數： ExpectedValue、 ExpressionOperator 和 PropertyType。
若只要檢查 MSI 產品程式代碼，請使用 Existence 參數，而不是評估規則。
| 類型: | SwitchParameter |
| 別名: | ValueRule |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
輸出
System.Object