New-CMDetectionClauseDirectory

  • リファレンス
モジュール:
ConfigurationManager

ファイル システム ディレクトリの検出方法句を作成します。

構文

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:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 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設定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Existence

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExpectedValue

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

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExpressionOperator

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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Is64Bit

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

アプリケーションの存在を示すフォルダーへのファイル システムのパスを指定します。 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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PropertyType

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

Type:FileFolderProperty
Accepted values:DateCreated, DateModified
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value

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

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

Type:SwitchParameter
Aliases:ValueRule
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

入力

None

出力

System.Object