Set-SCOMMaintenanceMode

  • リファレンス
モジュール:
OperationsManager

アクティブなメンテナンス モードエントリを更新します。

構文

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

説明

Set-SCOMMaintenanceMode コマンドレットは、アクティブなメンテナンス モードエントリを更新します。 このコマンドレットを使用して、アクティブなエントリのみを更新できます。

リソースがメンテナンス モードの場合、System Center - Operations Manager では、アラート、通知、ルール、モニター、自動応答、状態の変更、新しいアラートが抑制されます。

メンテナンス モードのコメントまたは理由を変更できます。 Get-SCOMMaintenanceMode コマンドレットを使用して、更新するメンテナンス モード エントリを取得します。 メンテナンス期間の終了を指定します。

例

例 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."

次の使用例は、指定したドメインのすべてのアクティブなメンテナンス モード エントリを更新します。 最初のコマンドは、後で 1 日 の DateTime オブジェクトを作成し、それを $NewEndTime 変数に格納します。

2 番目のコマンドは、Contoso.com ドメイン内のすべてのクラス インスタンスを取得し、パイプライン演算子 (|) を使用してクラス インスタンス オブジェクトを Get-SCOMMaintenanceMode コマンドレットに渡し、メンテナンス モードのエントリ オブジェクトを取得します。 コマンドは、パイプライン演算子を使用して、これらのオブジェクトを Set-SCOMMaintenanceMode コマンドレットに 渡します。 このコマンドレットは、各オブジェクトの終了時刻を、$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 変数に格納します。

2 番目のコマンドは、$Instance変数に格納されているクラス インスタンスのメンテナンス モード エントリを取得し、そのエントリを $MMEntry 変数に格納します。

3 番目のコマンドは、後で 30 分間 DateTime オブジェクトを作成し、それを $NewEndTime 変数に格納します。

4 番目のコマンドは、$MMEntry変数に格納されているメンテナンス モード エントリのメンテナンス モード セッションを、$NewEndTime変数に格納されている DateTime オブジェクトに更新し、コメントを追加します。

パラメーター

-Comment

メンテナンス モード エントリのコメントを指定します。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-EndTime

メンテナンス モードが DateTime オブジェクトとして終了するタイミングを指定します。 5 分未満の間、リソースをメンテナンス モードにすることはできません。 DateTime オブジェクトを取得するには、Get-Date コマンドレットを使用します。 詳細を表示するには「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 コマンドレットを使用します。

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

-PassThru

コマンドレットが、パイプラインでコマンドで使用できるオブジェクトを作成または変更することを示します。 既定では、このコマンドレットによる出力はありません。

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

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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