New-CMTSStepConditionFolder
タスク シーケンス ステップのフォルダー プロパティ条件を作成します。
構文
New-CMTSStepConditionFolder
[-FolderDateTimeOperator <VariableOperatorType>]
-FolderPath <String>
[-FolderTimestamp <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットを使用して、タスク シーケンス ステップの フォルダー プロパティ条件オブジェクトを作成します。 次に、Condition パラメーターまたはAddConditionパラメーターを使用して** * 、New-CMTSStep _ または ** Set-CMTSStep * _** コマンドレットのいずれかを使用します。 たとえば 、Set-CMTSStepApplyDataImageです。
詳細については、「Use the task sequence editor: Conditions 」を参照してください。
この条件で実行できるチェックには、次の 2 種類があります。
- フォルダーが存在するかどうかを確認するには、必須の FolderPath パラメーターを使用 します。
- フォルダーのタイムスタンプも確認するには 、FolderTimestamp パラメーター と FolderDateTimeOperator パラメーターを使用 します。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1
この例では、Configuration Manager PowerShell モジュールのヘルプ ファイル フォルダーの存在とタイムスタンプを確認します。 フォルダーの条件オブジェクトを作成し、そのタイムスタンプが 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
コマンドレットを実行する前に確認メッセージを表示します。
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 |
-FolderDateTimeOperator
FolderTimestamp パラメーターを使用する場合は、このパラメーターを使用して、フォルダーのタイムスタンプを評価するタスク シーケンスの演算子を指定します。
Type: | VariableOperatorType |
Accepted values: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FolderPath
この条件のフォルダーの完全なパスを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FolderTimestamp
フォルダーのタイムスタンプを評価するには、このパラメーターを使用して datetime オブジェクトを指定します。 このオブジェクトを取得するには、組み込みの Get-Date コマンドレットを使用 します。
次に 、FolderDateTimeOperator パラメーターを使用して評価演算子を設定します。
Type: | DateTime |
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 |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
なし
出力
IResultObject
メモ
この戻り値オブジェクトとそのプロパティの詳細については、「SMS_TaskSequence_FolderConditionExpression WMI クラス」を参照してください。