New-SCOMMaintenanceSchedule

リファレンス

モジュール:: OperationsManager

メンテナンススケジュールを作成します。

構文

New-SCOMMaintenanceSchedule
   [-Name] <String>
   [-Recursive]
   [-Enabled]
   [-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>]

説明

New-SCOMMaintenanceSchedule コマンドレットは、メンテナンススケジュールを作成します。

リソースがメンテナンスモードの場合、Operations Manager はアラート、通知、ルール、モニター、自動応答、状態の変更、新しいアラートを抑制します。メンテナンススケジュールを使用して、一連のリソースをメンテナンスモードにするようにスケジュールできます。

このコマンドレットを使用すると、特定の日または曜日に 1 回、毎日、毎週、または毎月実行されるスケジュールを作成できます。このコマンドレットは、作成されたスケジュールの GUID を返します。

既定では、このコマンドレットは、管理グループへのアクティブな永続的な接続を使用します。 SCSession パラメーターを使用して、別の永続的な接続を指定します。 ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。詳細については、「Get-Help about_OpsMgr_Connections」と入力します。

例

例 1: 新しいメンテナンススケジュールに Windows コンピューターオブジェクトを追加する

PS C:\>$windowsComputer = Get-SCOMClass -DisplayName "Windows Computer" | Get-SCOMClassInstance | Where-Object { $_.DisplayName -eq 'Agent01.contoso.local' }
PS C:\>New-SCOMMaintenanceSchedule -Name 'Test Maintenance Schedule' -MonitoringObjects $windowsComputer.Id -ActiveStartTime $((Get-Date).AddMinutes(2)) -DurationInMinutes 240 -ReasonCode PlannedOther -FreqType 1 -Enabled

特定のサーバーの Windows コンピューターオブジェクトを追加する方法を示す例: 新しいメンテナンススケジュールに 240 分間 Agent01.contoso.com し、1 回だけ実行します。

例 2: 毎日のメンテナンススケジュールを作成する

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is UTC (Coordinated Universal Time)
PS C:\>$startDate = [DateTime]::SpecifyKind([DateTime]"2024-03-30T01:00:00", [System.DateTimeKind]::Utc)
PS C:\>$durationInMinutes = 90
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Daily Maintenance at 1AM" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 4 -FreqInterval 1 -Enabled

特定のサーバーおよび関連する監視オブジェクトの毎日のメンテナンススケジュールを設定する方法を示す例: Agent01.contoso.local、午前 1 時から 90 分間続きます。

例 3: 週単位のメンテナンススケジュールを作成する

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-03-29T02:00:00"
PS C:\>$durationInMinutes = 120
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Weekly Wednesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 8 -FreqInterval 8 -FreqRecurrenceFactor 1 -Enabled

特定のサーバーおよび関連する監視オブジェクト (Agent01.contoso.local、午前 2 時から 120 分間続く) に対して毎週のメンテナンススケジュールを毎週水曜日に構成する方法を示す例。

例 4: 毎月のメンテナンススケジュールを作成する

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-04-01T03:00:00"
PS C:\>$durationInMinutes = 180
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Monthly Second Tuesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 32 -FreqInterval 2 -FreqRelativeInterval 2 -FreqRecurrenceFactor 1 -Enabled

特定のサーバーおよび関連する監視オブジェクト (Agent01.contoso.local、午前 3 時から 180 分間続く) について、毎月第 2 火曜日に毎月のメンテナンススケジュールを確立する方法を示す例。

パラメーター

-ActiveEndDate

スケジュールの実行を停止する終了日時と終了時刻を指定します。このパラメーターが指定されていない場合、スケジュールは引き続き (または削除または無効になるまで) 実行されます。

たとえば、2016 年 5 月 1 日午前 9 時に終了するスケジュールを作成する場合は、ActiveEndDate として "01-05-2016 09:00:00" を指定する必要があります。ローカル時刻に必要な時刻を指定する文字列を渡すことができます。ただし、UTC 時刻を指定する場合は、DateTimeKind を UTC に設定した DateTime オブジェクトを指定する必要があります。

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

-ActiveStartTime

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

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

-Comments

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

型:	String
配置:	8
規定値:	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
Aliases:	DurationInMinutes
配置:	6
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Enabled

作成時にスケジュールを有効または無効にするかどうかを示します。これを false に設定すると、スケジュールが作成されますが、無効になります。

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

-FreqInterval

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

1 (1 回)。頻度間隔は使用されません。
4 (毎日)。各頻度間隔の日数。
8 (毎週)。 FreqInterval パラメーターは、次の 1 つ以上です (OR 論理演算子と組み合わせます)。
- 1 - 日曜日
- 2 - 月曜日
- 4 - 火曜日
- 8 - 水曜日
- 16 - 木曜日
- 32 - 金曜日
- 64 - 土曜日
16 (月単位)。月の頻度間隔の日。
- 1 - 日曜日
- 2 - 月曜日
- 3 - 火曜日
- 4 - 水曜日
- 5 - 木曜日
- 6 - 金曜日
- 7 - 土曜日
32 (毎月の相対値)。 FreqInterval パラメーターは、次のいずれかの値です。
- 8 - 日
- 9 - 平日
- 10 - 週末

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

-FreqRecurrenceFactor

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

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

-FreqRelativeInterval

ジョブが実行される日。スケジュールが OnceRecurrence スケジュール以外の場合は必須です。値は、FreqType値によって異なります。

このパラメーターには、次のいずれかの値を指定できます。

1 (最初)
2 (秒)
4 (3 番目)
8 (4 番目)
16 (最後)

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

-FreqType

ジョブを実行するタイミングを指定します。このパラメーターに使用できる値は次のとおりです。

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

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

-MonitoringObjects

メンテナンスモードに配置される監視オブジェクト GUID の配列を指定します。作成されたスケジュールがメンテナンスモードになる監視オブジェクトを指定するには、監視オブジェクトの ID 属性を渡す必要があります。

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

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

-Name

このコマンドレットが作成するスケジュールの名前を指定します。

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

-ReasonCode

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

このパラメーターに使用できる値は次のとおりです。

PlannedOther
UnplannedOther
PlannedHardwareMaintenance
UnplannedHardwareMaintenance
PlannedHardwareInstallation
UnplannedHardwareInstallation
PlannedOperatingSystemReconfiguration
UnplannedOperatingSystemReconfiguration
PlannedApplicationMaintenance
UnplannedApplicationMaintenance
ApplicationInstallation
ApplicationUnresponsive
ApplicationUnstable
SecurityIssue
LossOfNetworkConnectivity

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

-Recursive

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

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

-SCSession

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

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

-WhatIf

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

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

次の方法で共有

New-SCOMMaintenanceSchedule

構文

説明

例

例 1: 新しいメンテナンススケジュールに Windows コンピューターオブジェクトを追加する

例 2: 毎日のメンテナンススケジュールを作成する

例 3: 週単位のメンテナンススケジュールを作成する

例 4: 毎月のメンテナンススケジュールを作成する

パラメーター

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-SCSession

-WhatIf

その他のリソース

次の方法で共有

New-SCOMMaintenanceSchedule

構文

説明

例

例 1: 新しいメンテナンス スケジュールに Windows コンピューター オブジェクトを追加する

例 2: 毎日のメンテナンス スケジュールを作成する

例 3: 週単位のメンテナンス スケジュールを作成する

例 4: 毎月のメンテナンス スケジュールを作成する

パラメーター

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-SCSession

-WhatIf

関連リンク

その他のリソース

例 1: 新しいメンテナンススケジュールに Windows コンピューターオブジェクトを追加する

例 2: 毎日のメンテナンススケジュールを作成する

例 3: 週単位のメンテナンススケジュールを作成する

例 4: 毎月のメンテナンススケジュールを作成する