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[] |
配置: | 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 |