New-CMTSStepConditionFile

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

タスク シーケンス ステップのファイル プロパティ条件を作成します。

構文

New-CMTSStepConditionFile
   [-FileDateTimeOperator <VariableOperatorType>]
   -FilePath <String>
   [-FileTimestamp <DateTime>]
   [-FileVersion <String>]
   [-VersionOperator <VariableOperatorType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、タスク シーケンス ステップの ファイル プロパティ条件オブジェクトを作成します。 次に、Condition パラメーターまたはAddConditionパラメーターを使用して** * 、New-CMTSStep _ または ** Set-CMTSStep * _** コマンドレットのいずれかを使用します。 たとえば 、Set-CMTSStepApplyDataImageです。

詳細については、「Use the task sequence editor: Conditions 」を参照してください。

この条件で実行できるチェックには、次の 3 種類があります。

  • ファイルが存在するかどうかを確認するには、必要な FilePath パラメーターを使用 します。
  • ファイルのバージョンも確認するには 、FileVersion パラメーターと VersionOperator パラメーターを使用 します。
  • ファイルのタイムスタンプも確認するには 、FileTimestamp パラメーター と FileDateTimeOperator パラメーターを使用 します。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1

次の使用例は、Configuration Manager PowerShell モジュールのヘルプ ファイルの存在とタイムスタンプを確認します。 ファイルのファイル条件オブジェクトを作成し、タイムスタンプが 2021 年 8 月 2 日より大きい。

次に 、Set-CMTSStepRunPowerShellScriptコマンドレットを使用して、この条件オブジェクトを既定の OS展開タスク シーケンスのPowerShell スクリプトの実行ステップに追加します。

$file = "C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US\AdminUI.PS.dll-Help.xml"
$datetime = Get-Date ("August 2, 2021")

$condition = New-CMTSStepConditionFile -FilePath $file -FileTimestamp $datetime -FileDateTimeOperator Greater

$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"

Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -AddCondition $condition

このサンプル スクリプトは、手順で次の条件を作成します。

File C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US\AdminUI.PS.dll-Help.xml exists and timestamp greater than "8/1/2021 16:00:00"

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

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

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

FileTimestamp パラメーターを使用する場合は、このパラメーターを使用して、ファイルのタイムスタンプを評価するタスク シーケンスの演算子を指定します。

Type:VariableOperatorType
Accepted values:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FilePath

この条件のファイル名を含む完全なパスを指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FileTimestamp

ファイルのタイムスタンプを評価するには、このパラメーターを使用して datetime オブジェクトを指定します。 このオブジェクトを取得するには、組み込みの Get-Date コマンドレットを使用 します。

次に 、FileDateTimeOperator パラメーターを使用 して評価演算子を設定します。

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FileVersion

ファイルのバージョンを評価するには、このパラメーターを使用してバージョン文字列を指定します。

次に 、VersionOperator パラメーターを使用 して評価演算子を設定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

FileVersion パラメーターを 使用する場合 は、このパラメーターを使用して、ファイルのバージョンを評価するタスク シーケンスの演算子を指定します。

Type:VariableOperatorType
Accepted values:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

なし

出力

IResultObject

メモ

この戻り値オブジェクトとそのプロパティの詳細については、「SMS_TaskSequence_FileConditionExpression WMI クラス」を参照してください。