MSFT_StorageJob クラス

[アーティクル]
04/02/2024

ストレージジョブを表します。

次の構文は、マネージドオブジェクトフォーマット (MOF) コードをシンプルにしたものです。

ストレージジョブは、ストレージサブシステムでの実行時間の長い操作を表します。これらの操作は、次のいずれかの方法で開始できます。

この MOF で定義されているさまざまな管理インターフェイスを使用して、ユーザーが行う。
インテリジェントストレージサブシステムによって自動的に行われる。

構文

class MSFT_StorageJob : MSFT_StorageObject
{
  String   Name;
  String   Description;
  Datetime ElapsedTime;
  UInt16   ErrorCode;
  String   ErrorDescription;
  UInt16   JobState;
  String   JobStatus;
  UInt16   LocalOrUtcTime;
  UInt16   OperationalStatus[];
  String   StatusDescriptions[];
  UInt16   PercentComplete;
  Datetime StartTime;
  Datetime TimeBeforeRemoval;
  Datetime TimeOfLastStateChange;
  Datetime TimeSubmitted;
  Boolean  DeleteOnCompletion;
  Boolean  IsBackgroundTask;
  UInt16   RecoveryAction;
  String   OtherRecoveryAction;
};

メンバー

MSFT_StorageJob クラスには、次の種類のメンバーがあります。

メソッド
[プロパティ]

メソッド

MSFT_StorageJob クラスでは、次のメソッドを使用できます。

Method	説明
GetExtendedStatus	失敗したストレージジョブの拡張状態情報を取得します。
RequestStateChange	ジョブの状態を RequestedState パラメーターで指定された値に変更するように要求します。

プロパティ

MSFT_StorageJob クラスには、次のプロパティがあります。

DeleteOnCompletion

データ型: Boolean

アクセスの種類: 読み取り専用

TRUE の場合、ストレージジョブは短い時間間隔の後に自動的に削除されます。

説明

データ型: 文字列

アクセスの種類: 読み取り専用

ストレージジョブが追跡している操作のテキスト説明。

ElapsedTime

データ型: Datetime

アクセスの種類: 読み取り専用

ジョブがまだ実行されている場合、このプロパティは実行されている期間を示します。ジョブが完了すると、合計実行時間になります。

ErrorCode

データ型: UInt16

アクセスの種類: 読み取り専用

このストレージジョブが追跡していた操作が失敗した場合、プロバイダーはこのプロパティを、操作を呼び出したメソッドで定義されたエラーコードに設定します。このストレージジョブがバックグラウンドタスクを追跡していた場合、エラーコードは、次の値マップで定義されている任意の有効なストレージ管理エラーコードに設定できます。エラーが発生しなかった場合は、このプロパティを成功に設定する必要があります。操作が完了するまで、このプロパティは NULL にする必要があります。

ErrorDescription

データ型: 文字列

アクセスの種類: 読み取り専用

ベンダーのエラーの説明を含む自由形式の文字列。

IsBackgroundTask

データ型: Boolean

アクセスの種類: 読み取り専用

修飾子: 必須

TRUE の場合、このストレージジョブは、ストレージサブシステムによって開始された自動バックグラウンドタスクを表します。すべてのユーザーが開始した操作または管理が開始した操作では、この値を FALSE に設定する必要があります。

JobState

データ型: UInt16

アクセスの種類: 読み取り専用

修飾子: 必須

ジョブの状態。

新規 (2)

Starting (3)

実行中 (4)

中断 (5)

シャットダウン (6)

完了 (7)

終了 (8)

中止 (9)

例外 (10)

サービス (11)

クエリの保留中 (12)

Microsoft 予約済み (13..32767)

ベンダー予約済み (32768..65535)

JobStatus

データ型: 文字列

アクセスの種類: 読み取り専用

ジョブの状態を表す自由形式の文字列。プライマリ状態は OperationalStatus プロパティに反映されます。 JobStatus では、実装固有の追加の詳細が提供されます。

LocalOrUtcTime

データ型: UInt16

アクセスの種類: 読み取り専用

修飾子: 値 ( "ローカル時刻"、"UTC 時刻")、ValueMap ("1"、"2")

RunStartInterval プロパティと UntilTime プロパティの時刻値がローカル時刻または UTC 時刻を表すかどうかを示します。時刻の値は、このプロパティを UTC 時刻に設定することで、世界中で同期されます。

名前

データ型: 文字列

アクセスの種類: 読み取り専用

修飾子: 必須

ストレージジョブのシステム定義名。

OperationalStatus

データ型: UInt16 配列

アクセスの種類: 読み取り専用

修飾子: 必須

ストレージジョブに参加している各ストレージサブシステムの現在の状態を示します。

Value	意味
不明 0	動作状態が不明です。
その他 1	ベンダー固有の OperationalStatus は、OtherOperationalStatusDescription プロパティで指定されます。
OK 2	ストレージサブシステムはコマンドに応答しており、通常の動作状態です。
低下 3	ストレージサブシステムはコマンドに応答していますが、最適な動作状態で実行しているわけではありません。
ストレス 4	ストレージサブシステムは機能していますが、注意が必要です。たとえば、過負荷になっているか、過熱している可能性があります。
予測障害 5	ストレージサブシステムは機能していますが、近い将来に障害が発生する可能性があります。
エラー 6	エラーが発生しました。
回復不能エラー 7	回復不可能なエラーが発生しました。
開始中 8	ストレージサブシステムは開始中です。
停止中 9	ストレージサブシステムは停止中です。
停止 10	ストレージサブシステムは、正しい手順で停止またはシャットダウンされました。
サービス中 11	ストレージサブシステムは、構成、保守、クリーニング、または管理中です。
連絡なし 12	ストレージプロバイダーはストレージサブシステムを認識していますが、そのサブシステムと通信することはできません。
通信切断 13	ストレージプロバイダーはストレージサブシステムを認識しており、過去に通信しましたが、現在は通信できません。
中止 14	ストレージサブシステムが突然停止したため、構成または保守が必要になる場合があります。
休止 15	ストレージプロバイダーはストレージサブシステムに接続できますが、ストレージサブシステムは現在アクティブではありません。
エラー状態のサポートエンティティ 16	この値は、ストレージサブシステムが依存する別のデバイスまたは接続に注意が必要な可能性があることを示します。ストレージサブシステム自体に問題があることを必ずしも示しているわけではありません。
完了 17	ストレージサブシステムが操作を完了しました。この値は、操作の結果に応じて、”OK”、”エラー”、または”低下”と組み合わせる必要があります。
パワーモード 18	この値は、システム使用のために予約されています。
DMTF 予約済み ..	18 ~ 0x8000 (含まない) の値は、DMTF 用に予約されています。
ベンダー予約済み 0x8000..	0x8000 以上の値は、ベンダー向けに予約されています。

OtherRecoveryAction

データ型: 文字列

アクセスの種類: 読み取り専用

失敗した実行ジョブに対して実行されるベンダー固有の回復アクション。このプロパティは、RecoveryAction が Other に設定されている場合にのみ設定する必要があります。

PercentComplete

データ型: UInt16

アクセスの種類: 読み取り専用

修飾子: 必須, 単位 (パーセンテージ)

この値が要求された時点で完了したジョブの割合。

RecoveryAction

データ型: UInt16

アクセスの種類: 読み取り専用

失敗した実行ジョブに対して実行される回復アクションについて説明します。次の値のうちの 1 つです。

Value	意味
不明 0	必要な回復アクションが不明です。
その他 1	回復アクションは、OtherRecoveryAction プロパティで指定します。
続行しない 2	ストレージジョブの実行を停止し、その状態を適切に更新します。
次のジョブに進む 3	キュー内の次のジョブを続行します。
ジョブの再実行 4	ジョブを再実行します。

StartTime

データ型: Datetime

アクセスの種類: 読み取り専用

ジョブが開始された時刻。

StatusDescriptions

データ型: 文字列 配列

アクセスの種類: 読み取り専用

OperationalStatus 値の説明。たとえば、Stopping が OperationalStatus の値である場合、StatusDescriptions の対応する配列要素によって、オブジェクトが停止されている理由が説明される場合があります。

TimeBeforeRemoval

データ型: Datetime

アクセスの種類: 読み取り専用

ジョブの実行が完了した後にジョブが保持される時間 (秒単位)。 DeleteOnCompletion プロパティの値に関係なくメインジョブが一定期間存在している必要があります。

TimeOfLastStateChange

データ型: Datetime

アクセスの種類: 読み取り専用

ジョブの状態が最後に変更された時刻。ジョブの状態が変更されておらず、このプロパティに値がない場合は、0 に設定する必要があります。状態変更が要求されたが、拒否された場合、またはまだ処理されていない場合は、このプロパティの値を更新しないでください。

TimeSubmitted

データ型: Datetime

アクセスの種類: 読み取り専用

ジョブが実行されるよう送信された時刻。すべてのゼロの値は、所有する要素が日付と時刻を報告できないことを示します。したがって、 ScheduledStartTime と StartTime は、値が要求された時間を基準にした間隔として報告されます。

要件

要件	Value
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
名前空間	Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof

次の方法で共有

MSFT_StorageJob クラス

構文

メンバー

メソッド

プロパティ

要件

関連項目

フィードバック

その他のリソース