Set-CMMaintenanceWindow
修改維護期間。
語法
Set-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
-InputObject <IResultObject>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-MaintenanceWindow <IResultObject>
[-PassThru]
[-Schedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
-CollectionId <String>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-MaintenanceWindowName <String>
[-PassThru]
[-Schedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
-CollectionId <String>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-MaintenanceWindow <IResultObject>
[-PassThru]
[-Schedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
-CollectionName <String>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-MaintenanceWindowName <String>
[-PassThru]
[-Schedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
-CollectionName <String>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-MaintenanceWindow <IResultObject>
[-PassThru]
[-Schedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
-InputObject <IResultObject>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-MaintenanceWindowName <String>
[-PassThru]
[-Schedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 在集合上設定維護時段。
如需維護期間的詳細資訊，請參閱 How to use maintenance windows in Configuration Manager。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：修改維護期間，只套用至工作順序部署
此命令會修改集合上名為 DiskCleanup 且標識 碼為 XYZ0004D 的維護期間。 它會變更維護期間，只套用至工作順序。
Set-CMMaintenanceWindow -Name "DiskCleanup" -CollectionID "XYZ0004D" -ApplyTo TaskSequencesOnly參數
-ApplyTo
指定維護時段的類型：
-
Any：維護期間適用於所有部署。 -
SoftwareUpdatesOnly：維護期間僅適用於軟體更新部署。 -
TaskSequencesOnly：維護期間僅適用於工作順序部署。
| 類型: | MaintenanceWindowApplyTo |
| 接受的值: | Any, SoftwareUpdatesOnly, TaskSequencesOnly |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ApplyToSoftwareUpdateOnly
此參數已被取代。 使用 ApplyTo 參數搭配 SoftwareUpdatesOnly 值。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ApplyToTaskSequenceOnly
此參數已被取代。 使用 ApplyTo 參數搭配 TaskSequencesOnly 值。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionId
指定集合的識別碼，以設定維護時段。 這個識別碼是標準集合識別碼，例如 XYZ0003F。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionName
指定要設定維護時段的集合名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
新增此參數以在執行 Cmdlet 之前提示確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定集合的物件以設定維護時段。 若要取得此物件，請使用 Get-CMCollection Cmdlet。
| 類型: | IResultObject |
| 別名: | Collection, Site |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-IsEnabled
使用此參數來設定集合的維護期間是否為使用中：
-
$true：啟用維護期間。 部署只會在視窗的排程期間執行。 -
$false：停用維護期間。 部署會在設定時隨時執行。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-IsUtc
若要將維護期間排程設定為使用國際標準時間 (UTC) ，請將此參數設定為 $true。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-MaintenanceWindow
指定要設定的維護時段物件。 若要取得此物件，請使用 Get-CMMaintenanceWindow Cmdlet。
| 類型: | IResultObject |
| 別名: | ScheduleWindow |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-MaintenanceWindowName
指定要設定的維護時段名稱。
| 類型: | String |
| 別名: | Name |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PassThru
新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Schedule
指定維護期間發生時的排程物件。 若要取得此物件，請使用 New-CMSchedule Cmdlet。
維護時段物件會將排程儲存為令牌字串。 若要從另一個物件複製排程，請使用 Convert-CMSchedule Cmdlet。 例如，Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object