次の方法で共有


Set-SCOMMaintenanceMode

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

構文

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

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

型:String
配置:3
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EndTime

メンテナンス モードが DateTime オブジェクトとして終了するタイミングを指定します。 リソースを 5 分未満のメンテナンス モードにすることはできません。 DateTime オブジェクトを取得するには、Get-Date コマンドレットを使用します。 詳細については、「Get-Help Get-Date」と入力します。

型:DateTime
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MaintenanceModeEntry

MaintenanceWindow オブジェクト 配列を指定します。 MaintenanceWindow オブジェクトを取得するには、Get-SCOMMaintenanceMode コマンドレットを使用します。

型:MaintenanceWindow[]
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PassThru

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Reason

メンテナンス モードの理由を指定します。 このパラメーターに使用できる値は次のとおりです。

  • PlannedOther
  • UnplannedOther
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
型:MaintenanceModeReason
配置:4
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False