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 パラメーターを使用します。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 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: ルール評価検出方法を追加する
この例では、ルールベースの検出句を追加して、2020 年 12 月 30 日以降にフォルダーが変更されたことを確認します。
$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パラメーター
-DirectoryName
アプリケーションの存在を示すフォルダーの名前を指定します。 Path パラメーターを使用して、このフォルダーへのパスを指定します。
たとえば、Configuration Manager コンソールは既定で C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole インストールされます。 このフォルダーのルールを作成するには、このパラメーターを AdminConsole に、 Path パラメーターを %ProgramFiles(x86)%\Microsoft Endpoint Manager に設定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Existence
このパラメーターを追加するときは、このアプリケーションの存在を示すために、フォルダーがターゲット システムに存在する必要があります。
存在するだけではなく、このフォルダーのプロパティのルールを評価するには、 Value パラメーターを使用します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ExpectedValue
Value パラメーターを追加するときは、PropertyType と ExpressionOperator で ExpectedValue を使用します。 これらのパラメーターを使用する場合、フォルダーはこのアプリケーションの存在を示す規則を満たす必要があります。 この ExpectedValue パラメーターは、ファイル システムと比較する値を指定します。
この句の PropertyType パラメーターは、フォルダーが作成または変更された日付のみを受け入れるため、この値は有効な datetime を持つ文字列です。 たとえば、「 "2020-11-30T08:00:00Z" 」のように入力します。
| 型: | 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 |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Is64Bit
このパラメーターを追加して、このフォルダーが 64 ビット システムの 32 ビット アプリケーションに関連付けられていることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Path
アプリケーションの存在を示すフォルダーへのファイル システムのパスを指定します。 DirectoryName パラメーターを使用して、フォルダーの名前を指定します。
たとえば、Configuration Manager コンソールは既定で C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole インストールされます。 このフォルダーのルールを作成するには、このパラメーターを %ProgramFiles(x86)%\Microsoft Endpoint Manager に、 DirectoryName パラメーターを AdminConsole に設定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PropertyType
Value パラメーターを追加するときは、ExpressionOperator と ExpectedValue で PropertyType を使用します。 これらのパラメーターを使用する場合、フォルダーはこのアプリケーションの存在を示す規則を満たす必要があります。 この PropertyType パラメーターは、評価するフォルダー プロパティを指定します。
| 型: | FileFolderProperty |
| 指定可能な値: | DateCreated, DateModified |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Value
Value パラメーターを追加する場合、フォルダーはこのアプリケーションの存在を示す規則を満たす必要があります。 このパラメーターは、 ExpectedValue、 ExpressionOperator、 PropertyType の各パラメーターと共に使用します。
ルールを評価する代わりに、フォルダーが存在することを確認するには、 Exist パラメーターを使用します。
| 型: | SwitchParameter |
| Aliases: | ValueRule |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object