New-CMTSStepConditionSoftware
為工作順序步驟 建立已安裝的軟體 條件。
語法
New-CMTSStepConditionSoftware
[-IsAnyVersion <Boolean>]
-MsiFilePath <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 為工作順序步驟建立 已安裝的軟體 條件物件。 然後使用其中一 個 New-CMTSStep* 或 Set-CMTSStep* Cmdlet 搭配 Condition 或 AddCondition 參數。 例如, Set-CMTSStepApplyDataImage。
如需詳細資訊,請 參閱使用工作順序編輯器:條件。
注意事項
從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1
此範例會先建立Configuration Manager主控台 MSI 的條件物件。
然後,它會使用Set-CMTSStepRunPowerShellScript Cmdlet,將此條件物件新增至預設 OS 部署工作順序的 [執行PowerShell 腳本] 步驟。
$msi = "\\cm01.contoso.com\SMS_XYZ\bin\i386\adminconsole.msi"
$condition = New-CMTSStepConditionSoftware -MsiFilePath $msi -IsAnyVersion $true
$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"
Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -AddCondition $condition
此範例腳本會在步驟上建立下列條件:
Software An version of "Microsoft Endpoint Configuration Manager Console" installed
參數
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理萬用字元,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-IsAnyVersion
使用此參數來判斷條件如何符合 MSI 程式碼:
-
$true
:符合此產品的任何版本,僅限 MSI升級程式碼 -
$false
:比對此特定產品、MSI 產品程式碼 和 升級程式碼
如果您未指定此參數,預設會符合特定產品。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-MsiFilePath
指定要評估之 MSI 檔案的路徑。 Cmdlet 會從此 MSI 讀取產品詳細資料。 MSI 的路徑不會儲存,只是產品詳細資料。
例如,它會儲存Configuration Manager 2107 版的下列詳細資料AdminConsole.msi:
-
ProductCode
: {B3842C82-95EB-472C-940A-D82C4A10857D} -
ProductName
:Microsoft 端點Configuration Manager主控台 -
UpgradeCode
: {B038D5E8-6C93-4A05-9E21-240324CFDF0E} -
Version
: 5.2107.1059.1000
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
IResultObject
備註
如需這個傳回物件及其屬性的詳細資訊,請 參閱SMS_TaskSequence_SoftwareConditionExpression伺服器 WMI 類別。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應