New-CMTSStepConditionFolder

構文

New-CMTSStepConditionFolder
   [-FolderDateTimeOperator <VariableOperatorType>]
   -FolderPath <String>
   [-FolderTimestamp <DateTime>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

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

詳細については、「 タスク シーケンス エディターの使用: 条件」を参照してください。

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

• フォルダーが存在するかどうかを確認するには、必要な FolderPath パラメーターを使用します。
• また、フォルダーのタイムスタンプを確認するには、 FolderTimestamp パラメーターと FolderDateTimeOperator パラメーターを 使用します。

例

例 1

この例では、Configuration Manager PowerShell モジュールのヘルプ ファイル フォルダーの存在とタイムスタンプを確認します。 フォルダーの condition オブジェクトが作成され、そのタイムスタンプが 2021 年 8 月 2 日より大きくなっています。

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

$folder = "C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US"
$datetime = Get-Date ("August 2, 2021")

$condition = New-CMTSStepConditionFolder -FolderPath $folder -FolderTimestamp $datetime -FolderDateTimeOperator Greater

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

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

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

Folder C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US exists and timestamp greater than "8/1/2021 16:00:00"

パラメーター

-Confirm

-DisableWildcardHandling

-FolderDateTimeOperator

-FolderPath

-FolderTimestamp

-ForceWildcardHandling

-WhatIf

入力

None

出力

IResultObject

メモ

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

関連リンク

• Get-CMTSStepConditionFolder
• タスク シーケンス エディターを使用する: 条件