Set-CMTaskSequence
設定 Configuration Manager 工作順序。
語法
Set-CMTaskSequence
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-BootImageId <String>]
[-Category <String>]
[-CustomText <String>]
[-DeploymentPackageId <String>]
[-Description <String>]
[-DisableTaskSequence <Boolean>]
[-EnableNotification <Boolean>]
[-EnableTaskSequence <Boolean>]
[-HighPerformance <Boolean>]
-InputObject <IResultObject>
[-MaxRunTimeMins <Int64>]
[-NewName <String>]
[-PassThru]
[-ProgramName <String>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-RunAnotherProgram <Boolean>]
[-RunEveryTime <Boolean>]
[-RunOnAnyPlatform]
[-SuppressNotification <Boolean>]
[-UseBootImage <Boolean>]
[-UseDefaultText <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTaskSequence
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-BootImageId <String>]
[-Category <String>]
[-CustomText <String>]
[-DeploymentPackageId <String>]
[-Description <String>]
[-DisableTaskSequence <Boolean>]
[-EnableNotification <Boolean>]
[-EnableTaskSequence <Boolean>]
[-HighPerformance <Boolean>]
[-MaxRunTimeMins <Int64>]
[-NewName <String>]
[-PassThru]
[-ProgramName <String>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-RunAnotherProgram <Boolean>]
[-RunEveryTime <Boolean>]
[-RunOnAnyPlatform]
[-SuppressNotification <Boolean>]
-TaskSequenceId <String>
[-UseBootImage <Boolean>]
[-UseDefaultText <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTaskSequence
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-BootImageId <String>]
[-Category <String>]
[-CustomText <String>]
[-DeploymentPackageId <String>]
[-Description <String>]
[-DisableTaskSequence <Boolean>]
[-EnableNotification <Boolean>]
[-EnableTaskSequence <Boolean>]
[-HighPerformance <Boolean>]
[-MaxRunTimeMins <Int64>]
[-NewName <String>]
[-PassThru]
[-ProgramName <String>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-RunAnotherProgram <Boolean>]
[-RunEveryTime <Boolean>]
[-RunOnAnyPlatform]
[-SuppressNotification <Boolean>]
-TaskSequenceName <String>
[-UseBootImage <Boolean>]
[-UseDefaultText <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Set-CMTaskSequence Cmdlet 會修改 Configuration Manager 工作順序。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：取得工作順序並變更其名稱
PS XYZ:\> $TaskSequence = Get-CMTaskSequence -Name "TaskSequence01"
PS XYZ:\> Set-CMTaskSequence -InputObject $TaskSequence -NewName "NewTS01"第一個命令會取得名為TaskSequence01的工作順序物件，並將物件儲存在$TaskSequence變數中。
第二個命令會將儲存在 $TaskSequence 中的工作順序名稱變更為 NewTS01。
範例 2：傳遞工作順序並變更其名稱
PS XYZ:\> Get-CMTaskSequence -Name "TaskSequence02" | Set-CMTaskSequence -NewName "NewTS02"此命令會取得名為 TaskSequence02 的工作順序物件，並使用管線運算符將對象傳遞至 Set-CMTaskSequence，這會將工作順序對象的名稱變更為 NewTS02。
參數
-AddSupportedOperatingSystemPlatform
將支援的作業系統平台物件新增至工作順序。 若要取得支援的操作系統平台物件，請使用 Get-CMSupportedPlatform Cmdlet。
| 類型: | IResultObject[] |
| 別名: | AddSupportedOperatingSystemPlatforms |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-BootImageId
指定開機映像的識別碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Category
指定工作順序的類別。 您可以使用類別來分組工作順序。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CustomText
指定工作順序的自訂文字。 當工作順序執行時，自定義文字會出現在進度通知對話框中。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DeploymentPackageId
指定封裝的識別碼。 如果您為 RunAnotherProgram 參數指定$True值，則指定的封裝會在工作順序執行之前執行。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定工作順序的描述。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableTaskSequence
指出是否停用此工作順序。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EnableNotification
指出是否要啟用此工作順序的通知。
| 類型: | Boolean |
| 別名: | EnableNotifications |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EnableTaskSequence
指出是否要啟用此工作順序。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-HighPerformance
使用此參數可在工作順序屬性的 [ 效 能] 頁面上設定下列選項： 以高效能電源計劃執行。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定工作順序物件。 若要取得工作順序物件，請使用 Get-CMTaskSequence Cmdlet。
| 類型: | IResultObject |
| 別名: | TaskSequence |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-MaxRunTimeMins
指定工作順序的最大運行時間，以分鐘為單位。
| 類型: | Int64 |
| 別名: | Duration |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-NewName
指定工作順序的新名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PassThru
傳回目前的工作物件。 根據預設，這個 Cmdlet 不會產生任何輸出。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ProgramName
指定要從 DeploymentPackageId 參數指定的 Configuration Manager 軟體套件執行的程式名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RemoveSupportedOperatingSystemPlatform
從工作順序中移除支援的操作系統平台物件。 若要取得支援的操作系統平台物件，請使用 Get-CMSupportedPlatform Cmdlet。
| 類型: | IResultObject[] |
| 別名: | RemoveSupportedOperatingSystemPlatforms |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RunAnotherProgram
指出是否要在執行工作順序之前執行另一個程式。 使用 DeploymentPackageId 參數和 ProgramName 參數來指定程式 。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RunEveryTime
指出每次工作順序執行時， ProgramName 參數中指定的程式是否都會執行。 如果您指定$False的值，如果程式在過去已成功執行，則不會執行程式。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RunOnAnyPlatform
表示工作順序會在任何作業系統平台上執行。
| 類型: | SwitchParameter |
| 別名: | ClearSupportedOperatingSystemPlatforms |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SuppressNotification
指出是否要隱藏此工作順序的通知。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TaskSequenceId
指定工作順序的識別碼。
| 類型: | String |
| 別名: | Id, TaskSequencePackageId |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TaskSequenceName
指定工作順序的名稱。
| 類型: | String |
| 別名: | Name |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UseBootImage
指出工作順序是否使用使用 BootImageID 參數指定的開機映像。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UseDefaultText
指出工作順序執行時，是否要在進度通知對話框中使用預設文字。 如果您為此參數選取$False值，請務必使用 CustomText 參數指定自定義文字。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 未執行 Cmdlet。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object