共用方式為

New-CMTSStepConditionSoftware

  • 參考
模組:
ConfigurationManager

為工作順序步驟 建立已安裝的軟體 條件。

語法

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 類別。