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 パラメーターを追加するときは、PropertyType と ExpressionOperator で ExpectedValue を使用します。 これらのパラメーターを使用する場合、ファイルはこのアプリケーションの存在を示す規則を満たす必要があります。 この ExpectedValue パラメーターは、ファイル システムと比較する値を指定します。
比較する値は、指定した PropertyType によって異なります。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ExpressionOperator
Value パラメーターを追加するときは、PropertyType と ExpectedValue で ExpressionOperator を使用します。 これらのパラメーターを使用する場合、ファイルはこのアプリケーションの存在を示す規則を満たす必要があります。 この 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 パラメーターを追加するときは、ExpressionOperator と ExpectedValue で PropertyType を使用します。 これらのパラメーターを使用する場合、ファイルはこのアプリケーションの存在を示す規則を満たす必要があります。 この PropertyType パラメーターは、評価するファイル プロパティを指定します。
たとえば、このパラメーターを Version に設定し、 ExpressionOperator を IsEquals に、 ExpectedValue を 1.48.1.0 に設定します。 その後、ルールは、指定されたファイルが同じファイル バージョンであることを確認します。
| 型: | FileFolderProperty |
| 指定可能な値: | DateCreated, DateModified, Version, Size |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Value
Value パラメーターを追加する場合、ファイルはこのアプリケーションの存在を示す規則を満たす必要があります。 このパラメーターは、 ExpectedValue、 ExpressionOperator、 PropertyType の各パラメーターと共に使用します。
ルールを評価する代わりに、ファイルが存在することを確認するには、 Exist パラメーターを使用します。
| 型: | SwitchParameter |
| Aliases: | ValueRule |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object