New-CMMaintenanceWindow
建立集合的維護期間。
Syntax
New-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
[-InputObject] <IResultObject>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-Name <String>
-Schedule <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
[-CollectionId] <String>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-Name <String>
-Schedule <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
[-CollectionName] <String>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-Name <String>
-Schedule <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 建立集合的維護期間。 維護期間是Configuration Manager用戶端可以執行工作的週期性期間。 例如,套用軟體更新或安裝軟體。 此視窗可確保只有在不會影響生產力和執行時間時,才會發生重大系統變更。
如需維護期間的詳細資訊,請參閱如何在Configuration Manager中使用維護時段。
注意事項
從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:建立維護期間
第一個命令會使用 New-CMSchedule Cmdlet 來建立排程物件,然後將它儲存在 變數中 $MWSchedule
。
第二個命令會為指定的集合建立名為 MonthlySchedule 的 維護期間。
維護期間會使用儲存在變數中的 $MWSchedule
排程。
$MWSchedule = New-CMSchedule -DayOfWeek Friday -DurationCount 1 -DurationInterval Hours -RecurCount 1 -Start "10/12/2013 21:00:00"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name "MonthlySchedule" -Schedule $MWSchedule
範例 2:在集合之間複製維護期間
第一個命令會從識別碼為 XYZ0003F的集合取得維護期間。 然後,它會在識別碼為 XYZ0005D 且名稱相同、排程相同且僅適用于軟體更新的集合上建立維護期間。
$mw1 = Get-CMMaintenanceWindow -CollectionId "XYZ0003F" -MaintenanceWindowName "nightly SUM window"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name $mw1.Name -Schedule (Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules) -ApplyTo SoftwareUpdatesOnly
參數
-ApplyTo
指定要建立的維護時段類型:
Any
:維護期間適用于所有部署。SoftwareUpdatesOnly
:維護期間僅適用于軟體更新部署。TaskSequencesOnly
:維護期間僅適用于工作順序部署。
如果您未指定此參數,則 Any
為預設值。
Type: | MaintenanceWindowApplyTo |
Accepted values: | Any, SoftwareUpdatesOnly, TaskSequencesOnly |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplyToSoftwareUpdateOnly
此參數已被取代。 使用 ApplyTo 參數搭配 SoftwareUpdatesOnly 值。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplyToTaskSequenceOnly
此參數已被取代。 使用 ApplyTo 參數搭配 TaskSequencesOnly 值。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
指定要新增維護期間之集合的識別碼。 此識別碼是標準集合識別碼,例如 XYZ0003F
。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
指定要新增維護時段的集合名稱。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
新增此參數以在執行 Cmdlet 之前提示確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
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 |
-ForceWildcardHandling
此參數會處理萬用字元,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定集合的 物件,以新增維護期間。 若要取得此物件,請使用 Get-CMCollection Cmdlet。
Type: | IResultObject |
Aliases: | Collection, Site |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IsEnabled
若要在集合上建立維護時段,但不要使用它,請將此參數設定為 $false
。 如果您未包含此參數,此 Cmdlet 會啟用維護期間。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsUtc
若要將維護期間排程設定為使用國際標準時間 (UTC) ,請將此參數設定為 $true
。 如果您未包含此參數,排程會使用當地時間。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定維護期間的名稱。
Type: | String |
Aliases: | MaintenanceWindowName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Schedule
指定維護期間發生時的排程物件。 若要取得此物件,請使用 New-CMSchedule Cmdlet。
維護時段物件會將排程儲存為權杖字串。 若要從另一個物件複製排程,請使用 Convert-CMSchedule Cmdlet。 例如,Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules
。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
IResultObject
備註
如需此傳回物件及其屬性的詳細資訊,請 參閱SMS_ServiceWindow伺服器 WMI 類別。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應