次の方法で共有

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) について、毎月第 2 火曜日に毎月のメンテナンス スケジュールを確立する方法を示す例: Agent01.contoso.local。午前 3 時から 180 分続きます。

パラメーター

-ActiveEndDate

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

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

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

-ActiveStartTime

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

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

-Comments

メンテナンス スケジュールに対して人間が読み取り可能なコメントを指定します。

Type:String
Position:8
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
Aliases:DurationInMinutes
Position:6
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Enabled

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

Type:SwitchParameter
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 - 週末
Type:Int32
Position:10
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqRecurrenceFactor

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

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

-FreqRelativeInterval

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

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

  • 1 (最初)
  • 2 (秒)
  • 4 (3 番目)
  • 8 (4 番目)
  • 16 (最後)
Type:Int32
Position:12
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqType

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

  • 1 (1 回)
  • 4 (毎日)
  • 8 (毎週)
  • 16 (毎月)
  • 32 (パラメーター FreqInterval を基準とした月単位)
Type:Int32
Position:9
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MonitoringObjects

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

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

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

-Name

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

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

-ReasonCode

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

このパラメーターの有効値は、次のとおりです。

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

-Recursive

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

Type:SwitchParameter
Position:1
Default value:None
Required:False
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