New-CMDetectionClauseDirectory
ファイル システム ディレクトリの検出方法句を作成します。
構文
New-CMDetectionClauseDirectory
-DirectoryName <String>
-PropertyType <FileFolderProperty>
-ExpectedValue <String[]>
-ExpressionOperator <FileFolderRuleExpressionOperator>
[-Is64Bit]
-Path <String>
[-Value]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] New-CMDetectionClauseDirectory
-DirectoryName <String>
[-Is64Bit]
-Path <String>
[-Existence]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] 説明
このコマンドレットを使用して、アプリケーションの検出方法で句を作成します。 この句は、アプリケーションの存在を示すファイル システム フォルダーのルールです。
フォルダーの代わりにファイルを検出するには 、New-CMDetectionClauseFile コマンドレットを使用 します。
このコマンドレットを使用した後、展開の種類に 対して、Add コマンドレット または Set- コマンドレットのいずれかを使用します。 この検出句オブジェクトを AddDetectionClause パラメーターまたは RemoveDetectionClause パラメーターに渡 します。
検出句をグループ化するには、展開の種類のコマンドレットで GroupDetectionClauses パラメーターを使用します。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。
例
例 1: 存在検出方法を追加する
次の使用例は、特定の製品 ID とディレクトリ名が存在する必要がある検出句を追加します。
$app = Get-CMApplication -ApplicationName "CentralApp"
$guid = "9900a338-484b-4a18-884e-bce87654ce1b"
$clause1 = New-CMDetectionClauseWindowsInstaller -ProductCode $guid -Value -ExpressionOperator IsEquals -ExpectedValue "1.1.1.1"
$clause2 = New-CMDetectionClauseDirectory -DirectoryName "mymsi" -Path "C:\" -Existence
$app | Add-CMMsiDeploymentType -ContentLocation "\\myserver\mypath\mymsi.msi" -Force -AddDetectionClause ($clause1, $clause2)例 2: ルール評価検出方法の追加
次の使用例は、12/30/2020 以降にフォルダーが変更された場合に、ルールベースの検出句を追加します。
$clause1 = New-CMDetectionClauseDirectory -DirectoryName "AdminConsole" -Path "%ProgramFiles(x86)%\Microsoft Endpoint Manager" -Value -PropertyType DateCreated -ExpressionOperator GreaterThan -ExpectedValue "2020-11-30T08:00:00Z"
Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1パラメーター
アプリケーションの存在を示すフォルダーの名前を指定します。 Path パラメーター を使用 して、このフォルダーへのパスを指定します。
たとえば、Configuration Manager コンソールは既定でにインストールされます C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole 。 このフォルダーのルールを作成するには、このパラメーターをに設定し AdminConsole 、Path パラメーターを に設定します %ProgramFiles(x86)%\Microsoft Endpoint Manager 。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターを追加する場合、このアプリケーションの存在を示すために、フォルダーがターゲット システム上に存在している必要があります。
存在する代わりに、このフォルダーのプロパティのルールを評価するには 、Value パラメーターを使用します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Value パラメーターを追加する場合は 、ExpectedValue と PropertyTypeとExpressionOperator を使用します。 **** これらのパラメーターを使用する場合、フォルダーは、このアプリケーションの存在を示すルールを満たす必要があります。 この ExpectedValue パラメーターは、ファイル システムと比較する値を指定します。
この 句の PropertyType パラメーターは、フォルダーが作成または変更された日付のみを受け入れるので、この値は有効な日時を持つ文字列です。 たとえば、"2020-11-30T08:00:00Z" などです。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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 |
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターを追加して、このフォルダーが 64 ビット システム上の 32 ビット アプリケーションに関連付けられているかどうかを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
アプリケーションの存在を示すフォルダーへのファイル システムのパスを指定します。 DirectoryName パラメーターを使用して、フォルダーの名前を指定します。
たとえば、Configuration Manager コンソールは既定でにインストールされます C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole 。 このフォルダーのルールを作成するには、このパラメーターに %ProgramFiles(x86)%\Microsoft Endpoint Manager 、DirectoryName パラメーターをに設定します AdminConsole 。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Value パラメーターを追加 する場合 は 、ExpressionOperator と ExpectedValue で PropertyType を使用します。 これらのパラメーターを使用する場合、フォルダーは、このアプリケーションの存在を示すルールを満たす必要があります。 この PropertyType パラメーターは、評価するフォルダー プロパティを指定します。
| Type: | FileFolderProperty |
| Accepted values: | DateCreated, DateModified |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Value パラメーターを追加 する場合 、フォルダーは、このアプリケーションの存在を示すルールを満たす必要があります。 このパラメーターは 、ExpectedValue、ExpressionOperator、PropertyTypeのパラメーターと一緒に使用します。 ****
ルールを評価する代わりに、フォルダーが存在することを確認するには 、Exists パラメーターを使用します。
| Type: | SwitchParameter |
| Aliases: | ValueRule |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
なし
出力
System.Object