New-CMTSStepUpgradeOperatingSystem
建立 升級 OS 步驟,您可以將其新增至工作順序。
Syntax
New-CMTSStepUpgradeOperatingSystem
[-DriverPackage <IResultObject>]
[-DynamicUpdateSetting <DynamicUpdateOption>]
[-EditionIndex <Int32>]
[-IgnoreMessage <Boolean>]
[-ProductKey <String>]
[-ScanOnly <Boolean>]
[-SetupTimeout <Int32>]
[-SourcePath <String>]
[-StagedContent <String>]
[-UpgradePackage <IResultObject>]
[-SoftwareUpdate <IResultObject[]>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
此 Cmdlet 會建立新的 升級 OS 步驟物件。 然後使用 Add-CMTaskSequenceStep Cmdlet 將步驟新增至工作順序。 如需此步驟的詳細資訊,請 參閱關於工作順序步驟:升級 OS。
注意事項
從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1
此範例會先使用 Get-CMOperatingSystemInstaller Cmdlet 來取得 OS 升級套件的物件。 它會將這個物件儲存在 $osUpgPkg 變數中。 下一個步驟會使用$osUpgPkg物件作為 OS 升級套件,建立升級 OS步驟的 物件。
然後,它會取得工作順序物件,並將這個新步驟新增至索引 11 的工作順序。
$osUpgPkg = Get-CMOperatingSystemInstaller -Name "OSUpgradePkg01"
$step = New-CMTSStepUpgradeOperatingSystem -Name "Upgrade OS" -UpgradePackage $osUpgPkg -EditionIndex 1
$tsNameOsd = "Default OS upgrade"
$tsUpg = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsUpg | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
參數
-Condition
指定要與這個步驟搭配使用的條件物件。 若要取得這個物件,請使用其中一個工作順序條件 Cmdlet。 例如, Get-CMTSStepConditionVariable。
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
新增此參數以啟用 [ 發生錯誤時繼續] 步驟選項。 當您啟用此選項時,如果步驟失敗,工作順序會繼續。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
指定此工作順序步驟的選擇性描述。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
新增此參數以停用此工作順序步驟。
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriverPackage
指定驅動程式套件物件,以在升級期間將其驅動程式內容提供給 Windows 安裝程式。 若要取得此套件,請使用 Get-CMDriverPackage Cmdlet。
使用 StagedContent 參數來指定驅動程式內容的位置。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DynamicUpdateSetting
使用此參數可使用 Windows Update 動態更新 Windows 安裝程式。
DisablePolicy
:不要使用動態更新UsingPolicy
:啟用安裝程式以使用動態更新,例如搜尋、下載和安裝更新。OverridePolicy
:暫時即時覆寫本機原則,以執行動態更新作業。 電腦會從Windows Update取得更新。
Type: | DynamicUpdateOption |
Accepted values: | DisablePolicy, UsingPolicy, OverridePolicy |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EditionIndex
指定 OS 升級套件版本的整數值。 使用此參數搭配 UpgradePackage 參數。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此參數會處理萬用字元,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IgnoreMessage
將此參數設定為 $true
,以指定 Windows 安裝程式完成安裝,並忽略任何可關閉的相容性訊息。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定此步驟的名稱,以在工作順序中識別它。
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProductKey
指定要套用至升級程式的產品金鑰。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScanOnly
將此參數設定為 $true
,以執行 Windows 安裝程式相容性掃描,而不需要開始升級。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SetupTimeout
指定Configuration Manager在此步驟失敗之前的分鐘數。 如果 Windows 安裝程式停止處理,但未終止,這個選項會很有用。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdate
從 2107 版開始,指定軟體更新物件,以使用功能更新來升級用戶端的 Windows OS。 若要取得此物件,請使用 Get-CMSoftwareUpdate Cmdlet。
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourcePath
指定 Windows 安裝程式所使用的 Windows 媒體本機或網路路徑。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StagedContent
使用此參數搭配 DriverPackage 來指定驅動程式內容的位置。 您可以指定本機資料夾、網路路徑或工作順序變數。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradePackage
指定 OS 升級套件物件。 使用 EditionIndex 參數來設定版本。
若要取得此物件,請使用 Get-CMOperatingSystemInstaller Cmdlet。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
None
輸出
IResultObject
備註
如需此傳回物件及其屬性的詳細資訊,請 參閱SMS_TaskSequence_UpgradeOperatingSystemAction伺服器 WMI 類別。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應