共用方式為


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。 將此偵測子句對象傳遞至 AddDetectionClauseRemoveDetectionClause 參數。

若要將偵測子句分組,請在部署類型 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 搭配 PropertyTypeExpressionOperator。 當您使用這些參數時,MSI 版本必須滿足規則,以指出此應用程式是否存在。 這個 ExpectedValue 參數會指定要與裝置比較的值。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ExpressionOperator

當您新增 Value 參數時,請搭配 PropertyTypeExpectedValue 使用 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 參數時,請搭配 ExpressionOperatorExpectedValue 使用 PropertyType。 當您使用這些參數時,MSI 版本必須滿足規則,以指出此應用程式是否存在。

這個 PropertyType 參數目前僅支援單一值 ProductVersion

類型:MSIProperty
接受的值:ProductVersion
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Value

當您新增 Value 參數以及產品程式代碼時,MSI 版本也必須滿足規則,以指出此應用程式是否存在。 使用此參數搭配下列參數: ExpectedValueExpressionOperatorPropertyType

若只要檢查 MSI 產品程式代碼,請使用 Existence 參數,而不是評估規則。

類型:SwitchParameter
別名:ValueRule
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

輸入

None

輸出

System.Object