New-CMDetectionClauseWindowsInstaller

  • 参考
模块:
ConfigurationManager

为 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 之一。 将此检测子句对象传递给 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 参数时，将 ExpressionOperator 与 PropertyType 和 ExpectedValue 配合使用。 使用这些参数时，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 参数时，请将 PropertyType 与 ExpressionOperator 和 ExpectedValue 配合使用。 使用这些参数时，MSI 版本必须满足规则以指示存在此应用程序。

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

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

-Value

添加 Value 参数以及产品代码时，MSI 版本还必须满足指示存在此应用程序的规则。 将此参数与以下参数一起使用： ExpectedValue、 ExpressionOperator 和 PropertyType。

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

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

输入

None

输出

System.Object