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>]

说明

使用此 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 参数时,请将 ExpectedValuePropertyTypeExpressionOperator 配合使用。 使用这些参数时,MSI 版本必须满足规则以指示存在此应用程序。 此 ExpectedValue 参数指定要与设备进行比较的值。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ExpressionOperator

添加 Value 参数时,将 ExpressionOperatorPropertyTypeExpectedValue 配合使用。 使用这些参数时,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 参数时,请将 PropertyTypeExpressionOperatorExpectedValue 配合使用。 使用这些参数时,MSI 版本必须满足规则以指示存在此应用程序。

PropertyType 参数目前仅支持单个值 ProductVersion

类型:MSIProperty
接受的值:ProductVersion
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Value

添加 Value 参数以及产品代码时,MSI 版本还必须满足指示存在此应用程序的规则。 将此参数与以下参数一起使用: ExpectedValueExpressionOperatorPropertyType

若要仅检查 MSI 产品代码,请使用 “存在 ”参数,而不是评估规则。

类型:SwitchParameter
别名:ValueRule
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输入

None

输出

System.Object