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

この句の PropertyType パラメーターは、フォルダーが作成または変更された日付のみを受け入れるため、この値は有効な datetime を持つ文字列です。 たとえば、「 "2020-11-30T08:00:00Z" 」のように入力します。

型: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

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

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

-Value

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

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

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

入力

None

出力

System.Object