共用方式為

Set-SCOMMaintenanceMode

  • 參考
模組:
OperationsManager

匯報 作用中的維護模式專案。

Syntax

Set-SCOMMaintenanceMode
   [-MaintenanceModeEntry] <MaintenanceWindow[]>
   [-PassThru]
   [-EndTime] <DateTime>
   [[-Comment] <String>]
   [[-Reason] <MaintenanceModeReason>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-SCOMMaintenanceMode Cmdlet 會更新使用中的維護模式專案。 您可以使用此 Cmdlet 僅更新使用中的專案。

當資源處於維護模式時，System Center - Operations Manager 會隱藏警示、通知、規則、監視、自動響應、狀態變更，以及新的警示。

您可以變更維護模式的批註或原因。 使用 Get-SCOMMaintenanceMode Cmdlet 取得要更新的維護模式專案。 指定維護期間結束。

範例

範例 1：更新網域中資源的主動維護模式專案

PS C:\>$NewEndTime = (Get-Date).addDays(1)
PS C:\> Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMMaintenanceMode | Set-SCOMMaintenanceMode -EndTime $NewEndTime -Comment "Updating end time."

本範例會更新指定網域的所有作用中維護模式專案。 第一個命令會在日後建立 DateTime 物件，然後將它儲存在$NewEndTime變數中。

第二個命令會取得 Contoso.com 網域中的所有類別實例，並使用管線運算子 (|) 將類別實例對象傳遞至 Get-SCOMMaintenanceMode Cmdlet，以取得維護模式項目物件。 此命令會使用管線運算符將這些對象傳遞至 Set-SCOMMaintenanceMode Cmdlet。 此 Cmdlet 會將每個物件的結束時間更新為儲存在 $NewEndTime 變數中的 DateTime 物件。 此命令也包含每個更新維護模式專案的批註。

範例 2：更新指定資源的維護模式專案

PS C:\>$Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> $MMEntry = Get-SCOMMaintenanceMode -Instance $Instance
PS C:\> $NewEndTime = (Get-Date).addMinutes(30)
PS C:\> Set-SCOMMaintenanceMode -MaintenanceModeEntry $MMEntry -EndTime $NewEndTime -Comment "Adding 30 minutes to the end time."

此範例會擴充指定伺服器的維護模式。 第一個命令會取得名為 Server01.Contoso.com 的類別實例，然後將它儲存在$Instance變數中。

第二個命令會取得儲存在 $Instance 變數中之類別實例的維護模式專案，並將專案儲存在 $MMEntry 變數中。

第三個命令會在未來建立 DateTime 物件 30 分鐘，然後將它儲存在$NewEndTime變數中。

第四個命令會將儲存在 $MMEntry 變數之維護模式項目的維護模式會話更新為儲存在 $NewEndTime 變數中的 DateTime 物件，並新增批注。

參數

-Comment

指定維護模式專案的批注。

Type:String
Position:3
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

-EndTime

指定維護模式何時結束為 DateTime 物件。 資源在維護模式中不能少於五分鐘。 若要取得 DateTime 物件，請使用 Get-Date Cmdlet。 如需詳細資訊，請鍵入 Get-Help Get-Date。

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

-MaintenanceModeEntry

指定 MaintenanceWindow 物件的陣列。 若要取得 MaintenanceWindow 物件，請使用 Get-SCOMMaintenanceMode Cmdlet。

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

-PassThru

表示 Cmdlet 會建立或修改命令可以在管線中使用的物件。 根據預設，此 Cmdlet 不會產生任何輸出。

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

-Reason

指定維護模式的原因。 此參數可接受的值為：

  • PlannedOther
  • UnplannedOther
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
Type:MaintenanceModeReason
Position:4
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