New-CMTSStepConditionFile
タスク シーケンス ステップの ファイル プロパティ 条件を作成します。
構文
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 です。
詳細については、「 タスク シーケンス エディターの使用: 条件」を参照してください。
この条件で実行できるチェックには、次の 3 種類があります。
- ファイルが存在するかどうかを確認するには、必要な FilePath パラメーターを使用します。
- また、ファイルのバージョンを確認するには、 FileVersion パラメーターと VersionOperator パラメーターを 使用します。
- また、ファイルのタイムスタンプを確認するには、 FileTimestamp パラメーターと FileDateTimeOperator パラメーターを 使用します。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 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
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FileDateTimeOperator
FileTimestamp パラメーターを使用する場合は、このパラメーターを使用して、ファイルのタイムスタンプを評価するタスク シーケンスの演算子を指定します。
| 型: | VariableOperatorType |
| 指定可能な値: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FilePath
この条件のファイル名を含む完全パスを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FileTimestamp
ファイルのタイムスタンプを評価するには、このパラメーターを使用して datetime オブジェクトを指定します。 このオブジェクトを取得するには、組み込みの Get-Date コマンドレットを 使用します。
次に、 FileDateTimeOperator パラメーターを使用して、評価演算子を設定します。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FileVersion
ファイルのバージョンを評価するには、このパラメーターを使用してバージョン文字列を指定します。
次に、 VersionOperator パラメーターを使用して、評価演算子を設定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VersionOperator
FileVersion パラメーターを使用する場合は、このパラメーターを使用して、ファイルのバージョンを評価するタスク シーケンスの演算子を指定します。
| 型: | VariableOperatorType |
| 指定可能な値: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_FileConditionExpression」を参照してください。