標準修飾子

CIM に準拠している実装はすべて、標準の修飾子セットを処理する必要があります。 特定のオブジェクトに、すべての修飾子が一覧表示されている必要があります。 通常、拡張クラスは、クラス インスタンスやクラスに対するその他の操作のプロビジョニングを容易にするために、追加の修飾子を提供します。

修飾子を適用する責任はプロバイダーの責任です。 WMI では修飾子は適用されませんが、プロパティの使用方法をユーザーに通知するためにのみ使用されます。

注意

WMI は CIM 2.5 仕様に準拠しています。

修飾子には次の制限があります。

  • すべての標準修飾子を一緒に使用できるではありません。
  • 関連付けや参照など、すべてのコンストラクトにすべての修飾子を適用できるではありません。 これらの制限については、「適用対象」の一覧を参照してください。
  • 関連付けや参照などの特定のコンストラクトでは、一部の修飾子が相互に排他的であり、1 つの修飾子を使用すると、別の修飾子の値に対する制限を示す可能性があります。など、法的修飾子の使用はさらに制限される可能性があります。 これらの使用規則については、以下を参照してください。
  • 有効な修飾子は、関連付けや参照ではなく、プロパティ、メソッド、インスタンス、サブクラスなどのエンティティによってのみ継承されます。 たとえば、プロパティ に適用される MaxLen 修飾子は参照によって継承されません。

WMI 標準修飾子の一覧を次に示します。

抽象

データ型: ブール値

適用対象: クラス、関連付け、表示

クラスが抽象クラスであり、新しいクラスのベースとしてのみ機能するかどうかを示します。 既定値は FALSE です。 抽象クラスのインスタンスを作成することはできません。 この修飾子がない場合は、 クラスが抽象でがないことを示します。したがって、この修飾子は、すべての抽象クラスに必要です。

集計

データ型: ブール値

適用対象: 参照

参照が集計関連付けの親コンポーネントであるかどうかを示します。 既定値は FALSE です

使用法: 集計 修飾子と****集計修飾子は 一緒に使用され、集計 は関連付けを指定し 、Aggregate は親参照を指定します。

集計

データ型: ブール値

適用対象: 関連付け

関連付けが集計であるかどうかを示します。 既定値は FALSE です。 集計 と一緒 に使用されます。 この修飾子は、すべての集計関連付けに必要です。

エイリアス

データ型: 文字列

適用対象: プロパティ、参照、メソッド

スキーマ内のプロパティまたはメソッドの代替名。 既定値は NULL です

ArrayType

データ型: 文字列

適用対象: プロパティ、パラメーター

修飾配列の型。

有効な値は次のとおりです。

  • bag (既定値)
  • インデックス付き
  • ordered

使用法: この種類の修飾子は、(角かっこ構文を使用して定義された) 配列であるプロパティとパラメーターにのみ適用します。

ビットマップ

データ型: 文字列配列

適用対象: プロパティ、メソッド、パラメーター

各重要な位置を "オン" または "オフ" にできる重要なビット位置のマップ。 各 "on" ビットは、BitValues 配列内の対応 する値にマップ されます。 複数のビットを "on" にすることで 、BitValues 配列内の複数の同時値が示されます。 既定値は NULL です

詳細については 、「BitMap と BitValues」を参照してください

BitValues

データ型: 文字列配列

適用対象: プロパティ、メソッド、パラメーター

関連付けられた文字列 へのビット位置値の 変換。 既定値は NULL です

詳細については 、「BitMap と BitValues」を参照してください

コンス トラクター

データ型: ブール値

適用対象: メソッド

メソッドがインスタンスを作成するかどうかを示します。 これらのメソッドは、1 つのインスタンスまたは 1 つのクラスに対する処理に制限されません。 たとえば、コンストラクターは、関連付けインスタンスと、コンストラクターを定義する クラスのインスタンスを作成できます。

コンストラクター 修飾子 は情報のみを対象としますが、オブジェクト マネージャーによって動作するとは限されません。 オブジェクト マネージャーは、オブジェクトの作成時にコンストラクター メソッドを呼び出す必要はありません。 また、コンストラクターが呼び出される場合、オブジェクト マネージャーは、元のクラスの親クラスに対して定義されているコンストラクター メソッドを呼び出す必要はありません。 既定値は FALSE です

CreateBy

データ型: 文字列

適用対象: クラス

このクラスのインスタンスの作成に使用するメソッドの名前。 値は、"PutInstance" またはインスタンスを作成する別のメソッドの名前です。 既定値は NULL です

使用法: この修飾子は 、SupportsCreate 修飾子が存在する場合にのみ 使用できます。

DeleteBy

データ型: 文字列

適用対象: クラス

このクラスのインスタンスを削除するメソッドの名前。 値は "DeleteInstance" か、インスタンスを削除する別のメソッドの名前です。 既定値は NULL です

使用法: この修飾子は 、SupportsDelete 修飾子が存在する場合 にのみ使用できます。

Description

データ型: 文字列

適用対象: 任意

名前付き要素の説明。 既定値は NULL です

デストラクター

データ型: ブール値

適用対象: メソッド

メソッドがインスタンスを削除するかどうかを示します。 デス トラクター修飾子を使用するメソッドは、デストラクターが適用されるインスタンスを削除します。また、単一のインスタンスまたはクラスに対する処理に制約されません。 たとえば、デストラクターは、関連付けインスタンスと、デストラクターを定義する クラスのインスタンスを削除できます。

デス トラクター修飾子は 情報のみを対象としますが、オブジェクト マネージャーによって動作するとは限されません。 インスタンスが削除された場合、オブジェクト マネージャーが デス トラクター修飾子を持つメソッドを呼び出す義務はありません。 また、デストラクターが呼び出される場合、オブジェクト マネージャーは、元のクラスの親クラスに対して定義されたデストラクター メソッドを呼び出す必要は一切ない。 既定値は FALSE です

DisplayName

データ型: 文字列

適用対象: 任意

要素の実際の名前ではなく、UI に表示される名前。 既定値は NULL です

EmbeddedInstance

データ型: 文字列

適用対象: 任意

修飾文字列型要素には、埋め込みインスタンスが含まれます。 修飾子の値は、修飾された要素を所有するクラスと同じ名前空間内の CIM クラスの名前を指定します。 埋め込みインスタンスは、サブクラスのインスタンスを含む、指定したクラスのインスタンスです。 既定値は NULL です

ゲージ

データ型: ブール値

適用対象: 任意

プロパティが負以外の整数を表すかどうかを示します。この整数は増減できますが、最大値を超える可能性があります。 既定値は FALSE です

プロパティの最大値を 2^n - 1 より大きくすることはできません。 N は、この修飾子が適用されるプロパティのデータ型に応じて、8、16、32、または 64 になります。 ゲージの値は、モデル化される情報が最大値以上の場合は常に最大値になります。 その後、モデル化される情報が最大値を下回る場合は、ゲージも減少します。 この修飾子は、符号なし整数データ型のプロパティにのみ適用されます。

インチ

データ型: ブール値

適用対象: パラメーター

パラメーターを使用してメソッドに値を渡すかどうかを示します。 既定値は TRUE です

In、Out

データ型: ブール値

適用対象: パラメーター

パラメーターが入力パラメーターと出力パラメーターの両方であるかどうかを示します。

キー

データ型: ブール値

適用対象: プロパティ、参照

プロパティが名前空間ハンドルの一部であるかどうかを示します。 複数のプロパティにキー修飾子がある 場合 、このようなプロパティはすべてまとめてキー (複合キー) を形成します。 組み合わせて使用する場合、キー プロパティはクラス インスタンスごとに一意の参照を指定する必要があります。 この修飾子がプロパティに配置されている場合は、値 TRUE のみを使用できます。

遅延

適用対象: プロパティ

プロパティが返されるリソースを集中的に使用し、大量のプロセッサ時間とメモリを必要とします。 WMI は、Lazy 修飾子でマークされたプロパティを返さなさそうとして、クエリのパフォーマンス を向上 させます。

MappingStrings

データ型: 文字列配列

適用対象: クラス、プロパティ、関連付け、表示、参照

プロパティ、クラス、関連付け、表示、または参照の原点に関する詳細を確認できる場所へのパスを示す値のセット。 マッピング文字列には、ディレクトリ パス、URL、レジストリ キー、含めるファイル、CIM クラスへの参照、または他の形式を指定できます。 既定値は NULL です

最大

データ型: int

適用対象: 参照

関連付け内の他の参照値のセットごとに、指定した参照に含まれる値の最大数。 既定値は NULL です。 たとえば、関連付けによって A インスタンスが B インスタンスに関連付けされ、B インスタンスごとに最大 1 つの A インスタンスが必要な場合、A への参照は最大 1 つの修飾子を持つ必要があります。

Maxlen

データ型: int

適用対象: プロパティ、メソッド、パラメーター

文字列データ項目の最大長 (文字数)。 固定長配列のサポートを示します。

固定長配列が見つかった場合 、MaxLen 修飾子には解析中に見つかった固定長が含されます。 可変長配列が検出された場合、この修飾子は使用されません。 MaxLen は、配列に格納する必要がある要素の最大数を提案するために使用されます。 既定値をオーバーライドする場合は、任意の符号なし整数値 (uint32) を指定できます。 NULL (既定値 ) の値 は、無制限の長さを意味します。

Maxvalue

データ型: int

適用対象: プロパティ、メソッド、パラメーター

オブジェクトの最大値。 既定値は NULL です

データ型: int

適用対象: 参照

参照の最小カーディナリティ (関連付け内の他の参照値のセットごとに、指定された参照が持つ値の最小数)。 既定値は 0 です。

たとえば、関連付けによって A インスタンスが B インスタンスに関連付けされ、B インスタンスごとに少なくとも 1 つの A インスタンスが必要な場合、A への参照には少なくとも 1 つの修飾子が必要です。

Minvalue

データ型: int

適用対象: プロパティ、メソッド、パラメーター

オブジェクトの最小値を示します。 既定値は NULL です

ModelCorrespondence

データ型: 文字列配列

適用対象: プロパティ

オブジェクトの プロパティと CIM スキーマ内の他のプロパティとの対応を示す値のセット。 既定値は NULL です

オブジェクトのプロパティは、次の構文を使用して識別されます。

"_" "."

非local

データ型: 文字列

適用対象: 参照

インスタンスの場所。namespacetype <名前空間>://<の値>既定値は NULL です

使用法: この修飾子は NonlocalType 修飾子と一緒に使用 できません。

NonlocalType

データ型: 文字列

適用対象: 参照

インスタンスの場所の種類。 その値は < namespacetype です > 。 既定値は NULL です。

使用法: この修飾子は、非 ローカル 修飾子と共に使用することはできません。

NullValue

データ型: 文字列

適用対象: プロパティ

関連付けられているプロパティが NULL である (プロパティに有効な値または有効な値がない) ことを示す値。 既定値は NULL です。

NULL 値の定義に使用される規則と制限は、 ValueMap 修飾子に適用される規則と制限と同じです。 メモこの修飾子はオーバーライドできません。 サブクラスが親クラスのものとは異なる NULL 値を返すことを許可するのは妥当ではありません。

入出力

データ型: ブール値

適用対象: パラメーター

パラメーターがメソッドから値を返すかどうかを示します。 既定値は FALSE です。

オーバーライド

データ型: 文字列

適用対象: プロパティ、メソッド、参照

派生クラス内の同じ名前のプロパティ、メソッド、または参照によってオーバーライドされる親クラスまたは下位コンストラクト (プロパティ、メソッド、または参照)。 既定値は NULL です。

形式は次のようになります:

[<クラス>。 ] <下位コンストラクト>

クラス名が省略されている場合は、クラス階層の親クラスの下位構造体にオーバーライドが適用されます。

使用法: オーバーライド 修飾子は、同じメタモデルのみに基づいてコンストラクトを参照できます。 オーバーライド操作中に、コンストラクトの名前またはシグネチャを変更することはできません。

OverrideValue

適用対象: クラス

サブクラスのプロパティ値が親クラスの値よりも優先されるかどうかを示します。 機能的には、親クラスに対してクエリを実行し、 WHERE 句にこのプロパティが含まれている場合、親はオーバーライドされた値を持つインスタンスを返す必要があるということです。 その結果、Windows 管理は、親クラスに送信されるクエリの where 句を調整して、このプロパティへの参照を除外します。

いつ

データ型: 文字列

適用対象: プロパティ

伝達されているキーの名前。 既定値は NULL です。

この修飾子を使用する場合は、包含クラスをターゲットとする参照に弱い修飾子が1つだけ存在することを前提としています。 関連付けられたプロパティの値は、弱いアソシエーションのもう一方の側のクラスの修飾子によって指定されたプロパティと同じである必要があります。 形式は次のようになります:

[<クラス>。 ] <下位コンストラクト>

使用法: 伝達 された修飾子を使用する場合は、 キー 修飾子を TRUE の値と共に指定する必要があります。

込ん

データ型: ブール値

適用対象: プロパティ

プロパティが読み取り可能かどうかを示します。 既定値は TRUE です。

必須

データ型: ブール値

適用対象: プロパティ

プロパティに null 以外の値が必要かどうかを示します。 既定値は FALSE です。

改定

データ型: 文字列

適用対象: クラス、アソシエーション、インジケーター、スキーマ

スキーマオブジェクトのマイナーリビジョン番号。 既定値は NULL です。

使用法:リビジョン 修飾子が使用されるときにメジャーバージョン番号を指定するには、バージョン 修飾子が必要です。

スキーマ

データ型: 文字列

適用対象: プロパティ、メソッド

フィーチャーが定義されているスキーマの名前。 既定値は NULL です。

電源

データ型: 文字列

適用対象: クラス、アソシエーション、インジケーター、参照

インスタンスの場所。 既定値は NULL です。

修飾子の値は <namespacetype>://<namespacehandle> です。

使用法: ソース 修飾子を SourceType 修飾子と共に使用することはできません。

SourceType

データ型: 文字列

適用対象: クラス、アソシエーション、インジケーター、参照

インスタンスの場所の種類。 この修飾子の値は、 namespacetype> <ます。 既定値は NULL です。

使用法: SourceType 修飾子を ソース 修飾子と共に使用することはできません。

SupportsCreate

データ型: ブール値

適用対象: クラス

クラスがインスタンスの作成をサポートしているかどうかを示します。 既定値は FALSE です。

SupportsDelete

データ型: ブール値

適用対象: クラス

クラスがインスタンスの削除をサポートしているかどうかを示します。 既定値は FALSE です。

SupportsUpdate

データ型: ブール値

適用対象: クラス

クラスがインスタンスの変更 (更新) をサポートするかどうかを示します。 既定値は FALSE です。

ターミナル

データ型: ブール値

適用対象: クラス

クラスがサブクラスを持つことができるかどうかを示します。 既定値は FALSE です。

サブクラスが宣言されている場合、コンパイラはエラーを生成します。

使用法: この修飾子を 抽象 修飾子と共存させることはできません。 ターミナル抽象 の両方の修飾子が指定されている場合、コンパイラはエラーを生成します。

部署

データ型: 文字列

適用対象: プロパティ、メソッド、パラメーター

関連付けられたデータ項目が表される単位の種類。 既定値は NULL です

たとえば、サイズ データ項目の値が Units の場合は "bytes" である場合があります

ValueMap

データ型: 文字列配列

適用対象: プロパティ、メソッド、パラメーター

プロパティ、メソッドの戻り値の型、またはメソッド パラメーターに許容される値のセット。 既定値は NULL です

使用法: この修飾子は、単独で使用するか、Values 修飾子と組み 合わせて使用 できます。 Values 修飾子と組み 合わせて使用 すると 、ValueMap 配列内の値の場所によって 、Values 配列内の対応するエントリの場所が提供されます。 ValueMap 修飾子は、 文字列値と整数値でのみ使用します。 値 map 配列で整数値を表す構文は、数字 [ + | = ] [ * です ] 。 コンテンツ、最大桁数、および表される値は、関連付けられているプロパティの型によって制限されます。 たとえば、uint8 は符号を付けず、4 桁未満である必要があります。また、256 未満の値を表す必要があります。

データ型: 文字列配列

適用対象: プロパティ、メソッド、パラメーター

整数値を関連付けられた文字列に変換する値のセット。 既定値は NULL です

このプロパティは、列挙プロパティにマップされる文字列値の配列も指定します。 この修飾子は、整数プロパティまたは文字列プロパティに適用できます。また、マッピングは暗黙的または明示的に指定できます。 マッピングが暗黙的な場合、整数または文字列のプロパティ値は Values 配列内の序数位置を します。 マッピングが明示的な場合、プロパティは整数である必要があります。有効なプロパティ値は ValueMap 修飾子で定義された配列 に一覧表示 されます。 詳細については、「値マップ」 を参照してください

ValueMap 修飾子が 存在しない場合 、Values 配列には、関連付けられたプロパティ、メソッドの戻り値の型、またはメソッド パラメーターの値を使用してインデックスが作成されます (相対値は 0)。 ValueMap 修飾子が 存在する場合、値インデックスは、値マップ内のプロパティ値の場所によって定義されます。

バージョン

データ型: 文字列

適用対象: クラス、スキーマ、関連付け、表示

スキーマ オブジェクトのメジャー バージョン番号。 既定値は NULL です。 バージョン番号は、インターフェイスを変更するスキーマに変更が加わるとインクリメントされます。

弱い

データ型: ブール値

適用対象: 参照

参照されるクラスのキーに、関連付け内の他の参加者のキーが含まれるかどうかを示します。 既定値は FALSE です

この修飾子は、参照されるクラスの ID が、関連付け内の他の参加者の ID に依存している場合に使用されます。 特定のクラスへの参照が 1 つ以上脆弱になる可能性はありません。 関連付け内の他のクラスは、キーを定義する必要があります。 関連付け内の他のクラスのキーは、参照先のクラスで繰り返され、伝達された修飾子で タグ付け されます。

書き込み

データ型: ブール値

適用対象: プロパティ

アプリケーションまたはスクリプトがプロパティ値を変更できるかどうかを示します。 アプリケーションを実行するアカウントは、 クラスのインスタンスを含む名前空間にアクセスできる必要があります。 プロバイダーの実装によって、プロバイダー データへのアクセスが制限される場合があります。 値 TRUE は 、プロパティ が読み取り可能であり、WMI とプロバイダーによるアクセスが許可されているコンシューマーによって書き込み可能な状態を示します。 既定値は FALSE です

Write 修飾子がないプロパティは、引 続き書き込み可能な場合があります。 プロバイダーの実装では、Write 修飾子が存在するかどうかに関わり、プロバイダー クラスのプロパティを 変更できます。

WriteAtCreate

データ型: ブール値

適用対象: プロパティ

プロパティがインスタンス作成時に書き込み可能かどうかを示します。 この修飾子は 、WriteAtCreate 修飾子と組み合わせて使用 できます。 既定値は FALSE です

WriteAtUpdate

データ型: ブール値

適用対象: プロパティ

プロパティがインスタンスの更新時に書き込み可能かどうかを示します。 この修飾子は 、WriteAtCreate 修飾子と組み合わせて使用 できます。 既定値は FALSE です

修飾子の取得の詳細については、TechNet ギャラリーの Get-WmiClassMethodsAndWritableWmiProperties PowerShell コード サンプルを参照してください。

要件

要件
サポートされている最小のクライアント
Windows Vista
サポートされている最小のサーバー
Windows Server 2008

関連項目

WMI 修飾子

修飾子の追加