New-SCOMMaintenanceSchedule

參考

模組:: OperationsManager

建立維護排程。

Syntax

New-SCOMMaintenanceSchedule
   [-Name] <String>
   [-Recursive]
   [-Enabled]
   [-MonitoringObjects] <Guid[]>
   [-ActiveStartTime] <DateTime>
   [[-ActiveEndDate] <DateTime>]
   [-Duration] <Int32>
   [-ReasonCode] <MaintenanceModeReason>
   [[-Comments] <String>]
   [-FreqType] <Int32>
   [[-FreqInterval] <Int32>]
   [[-FreqRecurrenceFactor] <Int32>]
   [[-FreqRelativeInterval] <Int32>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-SCOMMaintenanceSchedule Cmdlet 會建立維護排程。

當資源處於維護模式時，Operations Manager 會隱藏警示、通知、規則、監視器、自動響應、狀態變更，以及新的警示。維護排程可用來排程一組要進入維護模式的資源。

您可以使用此 Cmdlet 來建立排程，以在特定日或一周的一天或一天執行一次、每日、每周或每月。此 Cmdlet 會傳回所建立排程的 GUID。

根據預設，此 Cmdlet 會使用與管理群組的作用中持續性連線。使用 SCSession 參數來指定不同的持續性連線。您可以使用 ComputerName 和 Credential 參數，建立與管理群組的暫時連線。如需詳細資訊，請鍵入 Get-Help about_OpsMgr_Connections。

範例

範例 1：將 Windows Computer 物件新增至新的維護排程

PS C:\>$windowsComputer = Get-SCOMClass -DisplayName "Windows Computer" | Get-SCOMClassInstance | Where-Object { $_.DisplayName -eq 'Agent01.contoso.local' }
PS C:\>New-SCOMMaintenanceSchedule -Name 'Test Maintenance Schedule' -MonitoringObjects $windowsComputer.Id -ActiveStartTime $((Get-Date).AddMinutes(2)) -DurationInMinutes 240 -ReasonCode PlannedOther -FreqType 1 -Enabled

顯示如何針對特定伺服器新增 Windows Computer Object 的範例： Agent01.contoso.com 到新的維護排程，持續時間為 240 分鐘，只執行 1 次。

範例 2：建立每日維護排程

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is UTC (Coordinated Universal Time)
PS C:\>$startDate = [DateTime]::SpecifyKind([DateTime]"2024-03-30T01:00:00", [System.DateTimeKind]::Utc)
PS C:\>$durationInMinutes = 90
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Daily Maintenance at 1AM" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 4 -FreqInterval 1 -Enabled

顯示如何為特定伺服器和相關聯的監視物件設定每日維護排程的範例： Agent01.contoso.local，從上午 1：00 開始，並持續 90 分鐘。

範例 3：建立每周維護排程

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-03-29T02:00:00"
PS C:\>$durationInMinutes = 120
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Weekly Wednesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 8 -FreqInterval 8 -FreqRecurrenceFactor 1 -Enabled

範例顯示如何針對特定伺服器和相關聯的監視物件設定每周每周維護排程： Agent01.contoso.local，從上午 2：00 開始，並持續 120 分鐘。

範例 4：建立每月維護排程

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-04-01T03:00:00"
PS C:\>$durationInMinutes = 180
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Monthly Second Tuesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 32 -FreqInterval 2 -FreqRelativeInterval 2 -FreqRecurrenceFactor 1 -Enabled

範例顯示如何針對特定伺服器和相關聯的監視物件，在每個月的第二個星期二建立每月維護排程： Agent01.contoso.local，從上午 3：00 開始，持續 180 分鐘。

參數

-ActiveEndDate

指定排程應該停止執行的結束日期和結束時間。如果未指定此參數，排程將會繼續執行 (，直到刪除或停用) 為止。

例如，如果您想要建立應該在 2016 年 5 月 1 日上午 9：00 結束的排程，您必須將 “01-05-2016 09：00：00” 指定為 ActiveEndDate。您可以傳遞字串，以指定您想要在當地時間的時間。不過，如果您想要指定 UTC 時間，您應該指定 DateTime 物件，並將 DateTimeKind 設定為 UTC。

Type:	DateTime
Position:	5
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ActiveStartTime

指定排程必須作用中的開始日期和時間。例如，如果您想要建立應該從 2016 年 5 月 1 日開始的排程，且必須在上午 9：00 執行，您必須將 “01-05-2016 09：00：00” 指定為 ActiveStartTime。您可以傳遞字串，以指定您想要在當地時間的時間。不過，如果您想要指定 UTC 時間，您必須指定 DateTime 物件，並將 DateTimeKind 設定為 UTC。

Type:	DateTime
Position:	4
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Comments

指定維護排程的任何人類可讀取批注。

Type:	String
Position:	8
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

指定電腦名稱的陣列。 Cmdlet 會為這些電腦建立與管理群組的暫時連線。您可以使用 NetBIOS 名稱、IP 位址或完整功能變數名稱， (FQDN) 。若要指定本機電腦，請輸入電腦名稱、localhost 或句點 (.)。

System Center 資料存取服務必須在計算機上作用中。如果您未指定計算機，Cmdlet 會使用計算機進行目前的管理群組連線。

Type:	String[]
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:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

指定管理群組連線的 PSCredential 物件。若要取得 PSCredential 物件，請使用 Get-credential Cmdlet。如需詳細資訊，請輸入 Get-Help Get-Credential。如果您在 ComputerName 參數中指定電腦，請使用可存取該電腦的帳戶。預設為目前使用者。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Duration

指定維護排程的持續時間。維護排程的持續時間是維護排程最後一次的時間。

Type:	Int32
Aliases:	DurationInMinutes
Position:	6
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Enabled

指出排程將在建立時啟用或停用。如果您將此設定為 false，將會建立排程，但將會停用。

Type:	SwitchParameter
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqInterval

指定何時要執行作業。此參數可以是下列其中一個值：

1 次 () 。未使用頻率間隔。
每日) 4 (。每個頻率間隔天數。
每周) 8 (。 FreqInterval 參數是下列一或多個 (結合 OR 邏輯運算子) ：
- 1 - 星期日
- 2 - 星期一
- 4 - 星期二
- 8 - 星期三
- 16 - 星期四
- 32 - 星期五
- 64 - 星期六
每月) 16 (。在月份的頻率間隔日。
- 1 - 星期日
- 2 - 星期一
- 3 - 星期二
- 4 - 星期三
- 5 - 星期四
- 6 - 星期五
- 7 - 星期六
32 (每月相對) 。 FreqInterval 參數是下列其中一個值：
- 8 - 日
- 9 - 工作日
- 10 - 週末

Type:	Int32
Position:	10
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqRecurrenceFactor

作業的各排程執行之間的週數或月數。只有在 FreqType 參數設定為 8、16 或 32 時，才會使用 FreqRecurrenceFactor。 FreqRecurrenceFactor 參數是整數，預設值為 0。

Type:	Int32
Position:	11
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqRelativeInterval

執行作業的天數。如果排程不是 OnceRecurrence 排程，則這是必要的。值取決於 FreqType 的值。

此參數可以是下列其中一個值：

1 (First)
2 (秒)
4 (第三)
8 (第四)
16 (Last)

Type:	Int32
Position:	12
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqType

指定何時要執行作業。此參數可接受的值為：

1 (一次)
4 (每天)
8 (每週)
16 (每月)
32 (每月，相對於參數 FreqInterval)

Type:	Int32
Position:	9
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MonitoringObjects

指定將置於維護模式的監視物件 GUIDS 陣列。若要指定建立排程將放入維護模式的監視物件，您必須傳遞監視物件的ID屬性。

您可以指定排程的一或多個監視物件。不過，您無法在沒有任何監視對象的情況下建立排程。

Type:	Guid[]
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

指定此 Cmdlet 所建立之排程的名稱。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ReasonCode

指定維護排程的原因碼，指定維護期間的原因。

此參數可接受的值為：

PlannedOther
UnplannedOther
PlannedHardwareMaintenance
UnplannedHardwareMaintenance
PlannedHardwareInstallation
UnplannedHardwareInstallation
PlannedOperatingSystemReconfiguration
UnplannedOperatingSystemReconfiguration
PlannedApplicationMaintenance
UnplannedApplicationMaintenance
ApplicationInstallation
ApplicationUnresponsive
ApplicationUnstable
SecurityIssue
LossOfNetworkConnectivity

Type:	MaintenanceModeReason
Accepted values:	PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:	7
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Recursive

指出排程適用於最上層資源或所有自主資源。如果遞歸參數設定為 false，則執行排程時，只有指定的資源會進入維護模式。如果此值設定為 true，則指定的資源和與此資源具有內含項目關聯性的所有資源也會進入維護模式。

Type:	SwitchParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SCSession

指定 Connection 物件的陣列。

Type:	Connection[]
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:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

共用方式為

New-SCOMMaintenanceSchedule

Syntax

Description

範例

範例 1：將 Windows Computer 物件新增至新的維護排程

範例 2：建立每日維護排程

範例 3：建立每周維護排程

範例 4：建立每月維護排程

參數

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-SCSession

-WhatIf

其他資源

共用方式為

New-SCOMMaintenanceSchedule

Syntax

Description

範例

範例 1：將 Windows Computer 物件新增至新的維護排程

範例 2：建立每日維護排程

範例 3：建立每周維護排程

範例 4：建立每月維護排程

參數

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-SCSession

-WhatIf

相關連結

其他資源