New-CMDetectionClauseFile

ファイルの検出方法句を作成します。

構文

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 パラメーターを使用します。

注:

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

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

この例では、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 と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Existence

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

存在するだけではなく、このファイルのプロパティのルールを評価するには、 Value パラメーターを使用します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExpectedValue

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

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

型:String[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExpressionOperator

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

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

型:FileFolderRuleExpressionOperator
指定可能な値:IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る: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 に設定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Is64Bit

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る: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 に設定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PropertyType

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

たとえば、このパラメーターを Version に設定し、 ExpressionOperatorIsEquals に、 ExpectedValue1.48.1.0 に設定します。 その後、ルールは、指定されたファイルが同じファイル バージョンであることを確認します。

型:FileFolderProperty
指定可能な値:DateCreated, DateModified, Version, Size
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Value

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

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

型:SwitchParameter
Aliases:ValueRule
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

System.Object