New-CMTSStepInstallApplication
建立 [ 安裝 應用程式] 步驟,您可以將其新增至工作順序。
語法
New-CMTSStepInstallApplication
[-Application <IResultObject[]>]
[-BaseVariableName <String>]
[-ClearCache <Boolean>]
[-ContinueOnInstallError]
[-RetryCount <Int32>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
此 Cmdlet 會建立新的 安裝應用程式 步驟物件。 然後使用 Add-CMTaskSequenceStep Cmdlet 將步驟新增至工作順序。 如需此步驟的詳細資訊,請 參閱關於工作順序步驟:安裝應用程式。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1
此範例會先取得 Central 應用程式 的應用程式物件,並將它儲存在 $app 變數中。
下一行會使用 $app 變數,建立安裝應用程式步驟的物件。
然後,它會取得工作順序物件,並將這個新步驟新增至索引 11 的工作順序。
$app = Get-CMApplication -Name "Central app"
$step = New-CMTSStepInstallApplication -Name "Install Application" -Application $app
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
參數
-Application
指定要安裝的一或多個應用程式物件。 若要取得此物件,請使用 Get-CMApplication Cmdlet。
類型: | IResultObject[] |
別名: | Applications |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-BaseVariableName
使用此參數可根據動態變數清單安裝應用程式。 然後工作順序會使用這個基底變數名稱來安裝應用程式。 如需詳細資訊,請 參閱根據動態變數清單安裝應用程式。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ClearCache
將此參數設定為 , $true
以在安裝應用程式之後從用戶端快取清除應用程式內容。 對於具有小型硬碟的裝置,或連續安裝大量大型應用程式時,此行為非常有説明。
類型: | Boolean |
別名: | RemoveFromCache |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Condition
指定要與這個步驟搭配使用的條件物件。 若要取得這個物件,請使用其中一個工作順序條件 Cmdlet。 例如, Get-CMTSStepConditionVariable。
類型: | IResultObject[] |
別名: | Conditions |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ContinueOnError
新增此參數以啟用 [ 發生錯誤時繼續] 步驟選項。 當您啟用此選項時,如果步驟失敗,工作順序會繼續。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ContinueOnInstallError
新增此參數,以在應用程式無法安裝時繼續在清單中安裝其他應用程式。 如果您未指定此設定,且安裝失敗,則步驟會立即結束。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Description
指定此工作順序步驟的選擇性描述。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Disable
新增此參數以停用此工作順序步驟。
類型: | SwitchParameter |
別名: | DisableThisStep |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Name
指定此步驟的名稱,以在工作順序中識別它。
類型: | String |
別名: | StepName |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-RetryCount
如果其中一個應用程式安裝意外重新啟動計算機,請針對您使用此參數指定的次數重試此步驟。 根據預設,步驟會重試兩次。 指定從 1
到 5
的整數值。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
IResultObject
備註
如需這個傳回物件及其屬性的詳細資訊,請 參閱SMS_TaskSequence_InstallApplicationAction伺服器 WMI 類別。