Start-SCOMMaintenanceMode
オブジェクトをメンテナンス モードにし、アクティブなメンテナンス モード エントリを作成します。
構文
Start-SCOMMaintenanceMode
[-Instance] <MonitoringObject[]>
[-EndTime] <DateTime>
[[-Comment] <String>]
[[-Reason] <MaintenanceModeReason>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Start-SCOMMaintenanceMode コマンドレットは、コンピューターや分散アプリケーションなどの監視対象オブジェクトをメンテナンス モードにし、アクティブなメンテナンス モード エントリを作成します。 リソースがメンテナンス モードの場合、System Center - Operations Manager では、アラート、通知、ルール、モニター、自動応答、状態の変更、新しいアラートが抑制されます。
メンテナンス モードにするクラス インスタンスと、メンテナンス期間の終了時刻を指定します。 コメントとメンテナンス モードの理由を含めることもできます。 Set-SCOMMaintenanceMode コマンドレットを使用すると、アクティブなメンテナンス モード エントリを更新し、Get-SCOMMaintenanceMode コマンドレットを使用してアクティブなエントリと非アクティブなエントリの両方を取得できます。
例
例 1: リソースをメンテナンス モードにする
PS C:\>$Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> $Time = ((Get-Date).AddMinutes(10))
PS C:\> Start-SCOMMaintenanceMode -Instance $Instance -EndTime $Time -Comment "Applying software update." -Reason "SecurityIssue"
この例では、リソースを 10 分間メンテナンス モードにします。 最初のコマンドは、Get-SCOMClassInstance コマンドレットを使用して、Server01.Contoso.com という名前のクラス インスタンスを取得します。
2 番目のコマンドは、DateTime オブジェクトを 10 分間作成し、それを $Time 変数に格納します。
3 番目のコマンドは、$Instance変数に格納されているオブジェクトによって定義されたリソースをメンテナンス モードにします。 メンテナンス モードは、$Time変数に格納された時点で終了します。 このコマンドには、メンテナンス モードの理由とコメントが含まれています。
パラメーター
-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 |
-Instance
インスタンスを表す監視オブジェクトの配列を指定します。 監視オブジェクトを取得するには、Get-SCOMClassInstance コマンドレットを使用します。
このパラメーターは、グループ オブジェクトも受け入れます。 グループ オブジェクトを取得するには、Get-SCOMGroup コマンドレットを使用します。
型: | MonitoringObject[] |
配置: | 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 |