Edit-SCOMMaintenanceSchedule
既存のメンテナンス スケジュールを編集します。
構文
Edit-SCOMMaintenanceSchedule
[-ScheduleId] <Guid>
[[-Name] <String>]
[[-Recursive] <Boolean>]
[[-Enabled] <Boolean>]
[[-MonitoringObjects] <Guid[]>]
[[-ActiveStartTime] <DateTime>]
[[-ActiveEndDate] <DateTime>]
[[-Duration] <Int32>]
[[-ReasonCode] <MaintenanceModeReason>]
[[-Comments] <String>]
[[-FreqType] <Int32>]
[[-FreqInterval] <Int32>]
[[-FreqRecurrenceFactor] <Int32>]
[[-FreqRelativeInterval] <Int32>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Edit-SCOMMaintenanceSchedule コマンドレットは、既存のメンテナンス スケジュールを編集します。 ただし、現在アクティブなスケジュールは編集できません。
リソースがメンテナンス モードの場合、Operations Manager はアラート、通知、ルール、モニター、自動応答、状態の変更、新しいアラートを抑制します。 メンテナンス スケジュールを使用して、一連のリソースをメンテナンス モードにするようにスケジュールできます。
このコマンドレットを使用すると、特定の日または曜日に 1 回、毎日、毎週、または毎月実行するスケジュールを編集できます。 編集する既存のスケジュールの ScheduleId を渡す必要があります。 その他のパラメーターはすべて省略可能です。指定されたパラメーターが上書きされます。
既定では、このコマンドレットは、管理グループへのアクティブな永続的な接続を使用します。
SCSession パラメーターを使用して、別の永続的な接続を指定します。
ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。
詳細については、「Get-Help about_OpsMgr_Connections
」と入力します。
例
1: ID を使用してスケジュールされた System Center Operations Manager メンテナンス モードを編集する
PS C:\>Edit-SCOMMaintenanceSchedule -ScheduleId "32AAB279-3670-ED11-9626-00155D012405" -Enabled 1
ID 32AAB279-3670-ED11-9626-00155D012405でメンテナンス モード スケジュールを編集します。
2: 名前を使用してスケジュールされた System Center Operations Manager メンテナンス モードを編集する
PS C:\>Edit-SCOMMaintenanceSchedule -Name "Test" -Enabled 1
名前を使用してメンテナンス モード スケジュールを編集します。
パラメーター
-ActiveEndDate
スケジュールが停止する終了日と終了時刻を指定します。 このパラメーターを指定しない場合、スケジュールは削除または無効になるまで引き続き実行されます。
たとえば、2016 年 5 月 1 日午前 9 時に終了するスケジュールを作成する場合は、ActiveEndDate として "01-05-2016 09:00:00" を指定する必要があります。 ローカル時刻に必要な時刻を指定する文字列を渡すことができます。 ただし、UTC 時刻を指定する場合は、DateTimeKind が UTC に設定された DateTime オブジェクトを指定する必要があります。
型: | DateTime |
配置: | 6 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ActiveStartTime
スケジュールをアクティブにする必要がある開始日と時刻を指定します。
たとえば、2016 年 5 月 1 日から開始し、午前 9 時に実行する必要があるスケジュールが必要な場合は、ActiveStartTime として "01-05-2016 09:00:00" を指定する必要があります。
ローカル時刻に必要な時刻を指定する文字列を渡すことができます。
ただし、UTC 時刻を指定する場合は、DateTimeKind で dateTime オブジェクト
型: | DateTime |
配置: | 5 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Comments
メンテナンス スケジュールの人間が判読できるコメントを指定します。
型: | String |
配置: | 9 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ComputerName
コンピューターの名前の配列を指定します。 コマンドレットは、これらのコンピューターの管理グループとの一時的な接続を確立します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。System Center Data Access サービスは、コンピューター上でアクティブである必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Credential
管理グループ接続 PSCredential オブジェクトを指定します。
PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。
詳細については、「Get-Help Get-Credential
」と入力します。ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。
既定値は現在のユーザーです。
型: | PSCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Duration
メンテナンス スケジュールの期間を指定します。 メンテナンス スケジュールの期間は、メンテナンス スケジュールが毎回続く時間です。
型: | Int32 |
配置: | 7 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Enabled
編集時にスケジュールを有効または無効にするかどうかを示します。 これを false に設定すると、スケジュールは無効になります。 Enable-SCOMMaintenanceSchedule と Disable-SCOMMaintenanceSchedule を使用してこれを行うこともできます。
型: | Boolean |
配置: | 3 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FreqInterval
ジョブが実行される日を指定します。 スケジュールが OnceRecurrence スケジュール以外の場合、これは必須です。 値は、次の一覧に示すように、FreqType の値によって異なります。
- 1 (1 回)。 頻度間隔は使用されません。
- 4 (毎日)。 各頻度間隔の日数。
- 8 (毎週)。 FreqInterval パラメーターは、次の 1 つ以上です (OR 論理演算子と組み合わせます)。
---- 1 = 日曜日 ---- 2 = 月曜日 ---- 4 = 火曜日 ---- 8 = 水曜日 ---- 16 = 木曜日 ---- 32 = 金曜日 ---- 64 = 土曜日
- 16 (月単位)。 月の頻度間隔の日。
- 32 (毎月の相対値)。 FreqInterval パラメーターは、次のいずれかの値です。
---- 1 = 日曜日 ---- 2 = 月曜日 ---- 3 = 火曜日 ---- 4 = 水曜日 ---- 5 = 木曜日 ---- 6 = 金曜日 ---- 7 = 土曜日 ---- 8 = 日 ---- 9 = 平日 ---- 10 = 週末
型: | Int32 |
配置: | 11 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FreqRecurrenceFactor
ジョブのスケジュールされた実行の間の週数または月数。 FreqRecurrenceFactor は、FreqType パラメーターが 8、16、または 32 に設定されている場合にのみ使用されます。 FreqRecurrenceFactor パラメーターは整数で、既定値は 0 です。
型: | Int32 |
配置: | 12 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FreqRelativeInterval
FreqType パラメーターが 32 (毎月の相対) に設定されている場合のスケジュールを指定します。 このパラメーターには、次のいずれかの値を指定できます。
- 1 (最初)
- 2 (秒)
- 4 (3 番目)
- 8 (4 番目)
- 16 (最後)
型: | Int32 |
配置: | 13 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FreqType
ジョブを実行するタイミングを指定します。 このパラメーターには、次のいずれかの値を指定できます。
- 1 (1 回)
- 4 (毎日)
- 8 (毎週)
- 16 (毎月)
- 32 (パラメーター FreqIntervalを基準とした月単位)。
型: | Int32 |
配置: | 10 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MonitoringObjects
このコマンドレットがメンテナンス モードに設定する監視オブジェクトを表す GUID の配列を指定します。 メンテナンス モードに配置される監視オブジェクト GUID の配列を指定します。 スケジュールでメンテナンス モードにする監視オブジェクトを指定するには、監視オブジェクトの ID 属性を渡す必要があります。 既存のメンバーの一部を保持する場合は、それらも指定する必要があります。
スケジュールには、1 つ以上の監視オブジェクトを指定できます。 ただし、監視オブジェクトがないスケジュールを編集することはできません。
型: | Guid[] |
配置: | 4 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
スケジュールの名前を指定します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ReasonCode
メンテナンス期間の理由を指定するメンテナンス スケジュールの理由コードを指定します。
型: | MaintenanceModeReason |
指定可能な値: | PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity |
配置: | 8 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Recursive
スケジュールが最上位レベルのリソースまたは含まれているすべてのリソースにも適用されることを示します。 このパラメーターを false に設定すると、スケジュールの実行時に指定されたリソースのみがメンテナンス モードになります。 これが true に設定されている場合、指定されたリソースと、このリソースとの包含関係を持つすべてのリソースもメンテナンス モードになります。
型: | Boolean |
配置: | 2 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ScheduleId
このコマンドレットが編集するスケジュールの GUID を指定します。
型: | Guid |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SCSession
Connection オブジェクトの配列
型: | Connection[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |