通过

New-CMDetectionClauseFile

  • 参考
模块:
ConfigurationManager

为文件创建检测方法子句。

语法

New-CMDetectionClauseFile
   -FileName <String>
   -PropertyType <FileFolderProperty>
   -ExpectedValue <String[]>
   -ExpressionOperator <FileFolderRuleExpressionOperator>
   [-Is64Bit]
   -Path <String>
   [-Value]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
New-CMDetectionClauseFile
   -FileName <String>
   [-Is64Bit]
   -Path <String>
   [-Existence]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

说明

使用此 cmdlet 在应用程序的检测方法中创建子句。 此子句是指示存在应用程序的文件的规则。

若要检测文件夹而不是文件，请使用 New-CMDetectionClauseDirectory cmdlet。

使用此 cmdlet 后，请对部署类型使用其中一个 Add- 或 Set- cmdlet。 将此检测子句对象传递给 AddDetectionClause 或 RemoveDetectionClause 参数。

若要对检测子句进行分组，请在部署类型 cmdlet 上使用 GroupDetectionClauses 参数。

注意

从Configuration Manager站点驱动器运行Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1：按版本检测应用程序

此示例检测版本大于或等于 1.0.0的特定文件夹中的应用程序app.exe。

$clause = New-CMDetectionClauseFile -Path "C:\Program Files\Application" -FileName App.exe -Value -PropertyType Version -ExpressionOperator GreaterEquals -ExpectedValue "1.0.0"

Set-CMScriptDeploymentType -ApplicationName "CentralApp" -DeploymentTypeName "Scripted install" -AddDetectionClause $clause

示例 2：为 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 组合使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Existence

添加此参数时，文件必须存在于目标系统上，以指示存在此应用程序。

若要评估此文件属性的规则，请使用 Value 参数，而不是仅存在。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExpectedValue

添加 Value 参数时，请将 ExpectedValue 与 PropertyType 和 ExpressionOperator 配合使用。 使用这些参数时，文件必须满足规则，以指示存在此应用程序。 此 ExpectedValue 参数指定要与文件系统进行比较的值。

要比较的值取决于指定的 PropertyType。

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExpressionOperator

添加 Value 参数时，将 ExpressionOperator 与 PropertyType 和 ExpectedValue 配合使用。 使用这些参数时，文件必须满足规则，以指示存在此应用程序。 此 ExpressionOperator 参数指定将文件系统值与预期值进行比较的运算符。

从版本 2010 开始，参数类型从 RuleExpressionOperator 更改为 FileFolderRuleExpressionOperator。

Type:FileFolderRuleExpressionOperator
Accepted values:IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FileName

指定指示应用程序存在的文件的名称。 使用 Path 参数指定此文件的路径。

例如，Configuration Manager控制台默认安装到 C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe。 若要为此文件创建规则，请将此参数 Microsoft.ConfigurationManagement.exe 设置为 ，并将 Path 参数设置为 %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Is64Bit

添加此参数以指示此文件与 64 位系统上的 32 位应用程序相关联。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

指定文件系统中指示存在应用程序的文件的路径。 使用 FileName 参数指定文件的名称。

例如，Configuration Manager控制台默认安装到 C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe。 若要为此文件创建规则，请将此参数设置为 %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin ，并将 FileName 参数设置为 Microsoft.ConfigurationManagement.exe。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PropertyType

添加 Value 参数时，请将 PropertyType 与 ExpressionOperator 和 ExpectedValue 配合使用。 使用这些参数时，文件必须满足规则，以指示存在此应用程序。 此 PropertyType 参数指定要计算的文件属性。

例如，将此参数设置为 Version，将 ExpressionOperator 设置为 IsEquals， 并将 ExpectedValue 设置为 1.48.1.0。 然后，该规则将检查指定的文件是否具有相同的文件版本。

Type:FileFolderProperty
Accepted values:DateCreated, DateModified, Version, Size
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value

添加 Value 参数时，文件必须满足规则，以指示存在此应用程序。 将此参数与以下参数一起使用： ExpectedValue、 ExpressionOperator 和 PropertyType。

若要仅检查文件是否存在，请使用 Exists 参数，而不是评估规则。

Type:SwitchParameter
Aliases:ValueRule
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

输入

None

输出

System.Object