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

説明

このコマンドレットを使用して、アプリケーションの検出方法で句を作成します。 この句は、アプリケーションの存在を示すファイルのルールです。

ファイルの代わりにフォルダーを検出するには 、New-CMDetectionClauseDirectory コマンドレットを使用 します。

このコマンドレットを使用した後、展開の種類に 対して、Add コマンドレット または Set- コマンドレットのいずれかを使用します。 この検出句オブジェクトを AddDetectionClause パラメーターまたは RemoveDetectionClause パラメーターに渡 します。

検出句をグループ化するには、展開の種類のコマンドレットで GroupDetectionClauses パラメーターを使用します。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: バージョン別にアプリケーションを検出する

次の使用例は、バージョン app.exe 以上である特定のフォルダー内のアプリケーション ファイルを検出します 1.0.0 。

$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 アプリの展開の種類に複数の句を作成する

この例では、2 つのファイル句と 1 つのレジストリ句を作成し、それらを使用して 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
Accept pipeline input:False
Accept wildcard characters:False
-Existence

このパラメーターを追加する場合、このアプリケーションの存在を示すために、ファイルがターゲット システムに存在している必要があります。

存在する代わりに、このファイルのプロパティのルールを評価するには 、Value パラメーターを使用します。

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

Value パラメーターを追加する場合は 、ExpectedValue と PropertyTypeとExpressionOperator を使用します。 **** これらのパラメーターを使用する場合、ファイルは、このアプリケーションの存在を示すルールを満たす必要があります。 この ExpectedValue パラメーターは、ファイル システムと比較する値を指定します。

比較する値は、指定した PropertyType によって異なります。

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

Value パラメーターを追加 する場合 は 、PropertyType と ExpectedValue を持つ ExpressionOperator を使用します。 これらのパラメーターを使用する場合、ファイルは、このアプリケーションの存在を示すルールを満たす必要があります。 この ExpressionOperator パラメーター は、ファイル システム値と予想される値を比較する演算子を指定します。

バージョン 2010 から、パラメーターの種類が RuleExpressionOperator から FileFolderRuleExpressionOperator に変更されました。

Type:FileFolderRuleExpressionOperator
Accepted values:IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

このパラメーターを追加して、このファイルが 64 ビット システム上の 32 ビット アプリケーションに関連付けられているかどうかを示します。

Type:SwitchParameter
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
-PropertyType

Value パラメーターを追加 する場合 は 、ExpressionOperator と ExpectedValue で PropertyType を使用します。 これらのパラメーターを使用する場合、ファイルは、このアプリケーションの存在を示すルールを満たす必要があります。 この PropertyType パラメーターは、評価するファイル プロパティを指定します。

たとえば、このパラメーターをに設定し Version 、ExpressionOperator を 、および IsEquals ExpectedValue に設定します 1.48.1.0 。 次に、指定したファイルに同じファイル バージョンが含けられていることを確認します。

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

Value パラメーターを追加 する場合 、ファイルは、このアプリケーションの存在を示すルールを満たす必要があります。 このパラメーターは 、ExpectedValue、ExpressionOperator、PropertyTypeのパラメーターと一緒に使用します。 ****

ルールを評価する代わりに、ファイルが存在することを確認するには 、Exists パラメーターを使用します。

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

入力

なし

出力

System.Object