New-CMTSStepConditionFile
建立工作順序步驟 的文件屬性 條件。
語法
New-CMTSStepConditionFile
[-FileDateTimeOperator <VariableOperatorType>]
-FilePath <String>
[-FileTimestamp <DateTime>]
[-FileVersion <String>]
[-VersionOperator <VariableOperatorType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 建立工作順序步驟 的文件屬性 條件物件。 然後使用其中一 個 New-CMTSStep* 或 Set-CMTSStep* Cmdlet 搭配 Condition 或 AddCondition 參数。 例如， Set-CMTSStepApplyDataImage。
如需詳細資訊，請 參閱使用工作順序編輯器：條件。
您可以使用此條件執行三種類型的檢查：
- 若要檢查檔案是否存在，請使用必要的 FilePath 參數。
- 若要同時檢查檔案版本，請使用 FileVersion 和 VersionOperator 參數。
- 若要同時檢查檔案時間戳，請使用 FileTimestamp 和 FileDateTimeOperator 參數。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1
此範例會檢查其中一個 Configuration Manager PowerShell 模組說明檔是否存在和時間戳。 它會建立檔案的檔案條件物件，而且其時間戳大於 2021 年 8 月 2 日。
然後，它會使用 Set-CMTSStepRunPowerShellScript Cmdlet，將此條件物件新增至預設 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
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FileDateTimeOperator
當您使用 FileTimestamp 參數時，請使用此參數來指定工作順序的運算符，以評估檔案的時間戳。
| 類型: | VariableOperatorType |
| 接受的值: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FilePath
指定完整路徑，包括此條件的檔名。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FileTimestamp
若要評估檔案的時間戳，請使用此參數來指定 datetime 物件。 若要取得此物件，請使用內建的 Get-Date Cmdlet。
然後使用 FileDateTimeOperator 參數來設定評估運算符。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FileVersion
若要評估檔案的版本，請使用此參數來指定版本字串。
然後使用 VersionOperator 參數來設定評估運算符。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VersionOperator
當您使用 FileVersion 參數時，請使用此參數來指定工作順序的運算符，以評估檔案的版本。
| 類型: | VariableOperatorType |
| 接受的值: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
輸出
IResultObject
備註
如需此傳回物件及其屬性的詳細資訊，請 參閱SMS_TaskSequence_FileConditionExpression伺服器 WMI 類別。