Edit-SCOMMaintenanceSchedule

モジュール:

OperationsManager

既存のメンテナンス スケジュールを編集します。

構文

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 オブジェクトを指定する必要があります。

Type:	DateTime
Position:	6
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ActiveStartTime

スケジュールをアクティブにする必要がある開始日と時刻を指定します。 たとえば、2016 年 5 月 1 日から開始し、午前 9 時 00 分に実行する必要があるスケジュールが必要な場合は、ActiveStartTime として "01-05-2016 09:00:00" を指定する必要があります。 ローカル時刻に必要な時刻を指定する文字列を渡すことができます。 ただし、UTC 時刻を指定する場合は、 DateTimeKind を使用して DateTime オブジェクトを指定する必要があります。

Type:	DateTime
Position:	5
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Comments

メンテナンス スケジュールに対して人間が判読できるコメントを指定します。

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

-ComputerName

コンピューターの名前の配列を指定します。 コマンドレットは、これらのコンピューターの管理グループとの一時的な接続を確立します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。System Center Data Access サービスは、コンピューター上でアクティブである必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。

Type:	String[]
Position:	Named
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

-Credential

管理グループ接続の PSCredential オブジェクトを指定します。 PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細については、「」と入力します Get-Help Get-Credential。 ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Duration

メンテナンス スケジュールの期間を指定します。 メンテナンス スケジュールの期間は、メンテナンス スケジュールが毎回続く時間です。

Type:	Int32
Position:	7
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enabled

編集時にスケジュールを有効または無効にするかどうかを示します。 これを false に設定すると、スケジュールは無効になります。 Enable-SCOMMaintenanceSchedule と Disable-SCOMMaintenanceSchedule を使用してこれを行うこともできます。

Type:	Boolean
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 = 週末の日

Type:	Int32
Position:	11
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqRecurrenceFactor

ジョブのスケジュールされた実行の間の週または月数。 FreqRecurrenceFactor は、 FreqType パラメーターが 8、16、または 32 に設定されている場合にのみ使用されます。 FreqRecurrenceFactor パラメーターは整数で、既定値は 0 です。

Type:	Int32
Position:	12
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqRelativeInterval

FreqType パラメーターが 32 (月単位の相対値) に設定されている場合のスケジュールを指定します。 このパラメーターには、次のいずれかの値を指定できます。

• 1 (最初)
• 2 (秒)
• 4 (3 番目)
• 8 (第 4)
• 16 (最終)

Type:	Int32
Position:	13
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqType

ジョブを実行するタイミングを指定します。 このパラメーターには、次のいずれかの値を指定できます。

• 1 (1 回)
• 4 (毎日)
• 8 (毎週)
• 16 (毎月)
• 32 (パラメーター FreqInterval を基準とした月単位)。

Type:	Int32
Position:	10
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MonitoringObjects

このコマンドレットがメンテナンス モードに設定する監視オブジェクトを表す GUID の配列を指定します。 メンテナンス モードに配置される監視オブジェクト GUID の配列を指定します。 スケジュールでメンテナンス モードにする監視オブジェクトを指定するには、監視オブジェクトの ID 属性を渡す必要があります。 既存のメンバーの一部を保持する場合は、それらのメンバーも指定する必要があります。

スケジュールには、1 つ以上の監視オブジェクトを指定できます。 ただし、監視オブジェクトがないスケジュールを編集することはできません。

Type:	Guid[]
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

スケジュールの名前を指定します。

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

-ReasonCode

メンテナンス期間の理由を指定するメンテナンス スケジュールの理由コードを指定します。

Type:	MaintenanceModeReason
Accepted values:	PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:	8
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Recursive

スケジュールが最上位レベルのリソースまたは含まれるすべてのリソースにも適用されることを示します。 このパラメーターを false に設定すると、スケジュールの実行時に指定されたリソースのみがメンテナンス モードになります。 これが true に設定されている場合、指定されたリソースと、このリソースとの包含関係を持つすべてのリソースもメンテナンス モードになります。

Type:	Boolean
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScheduleId

このコマンドレットが編集するスケジュールの GUID を指定します。

Type:	Guid
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SCSession

Connection オブジェクトの配列を指定します。

Type:	Connection[]
Position:	Named
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

関連リンク

• Disable-SCOMMaintenanceSchedule
• Enable-SCOMMaintenanceSchedule
• Get-SCOMMaintenanceSchedule
• New-SCOMMaintenanceSchedule
• Remove-SCOMMaintenanceSchedule
• Stop-SCOMMaintenanceSchedule
• Update-SCOMMaintenanceSchedule