CIM_PhysicalLink クラス - WMI Library

CIM_PhysicalLink クラスの説明

CIM_PhysicalLink クラスは、物理要素のケーブルをまとめて表します。たとえば、シリアルまたはイーサネット ケーブルおよび赤外線リンクは、サブクラス (追加のプロパティまたは関連付けが定義されている場合) または CIM_PhysicalLink のインスタンスです。多くの場合において、物理パッケージまたはネットワークのさまざまな物理ケーブルは設計されていません。ただし、これらのケーブルまたはリンクが重大なコンポーネントであるか、またはタグ付きのアセットである場合、これらのオブジェクトはこのクラスまたはその子孫のクラスの 1 つを使用してインスタンス化されます。
UUIDは、{FAF76B82-798C-11D2-AAD1-006008C78BC7}です。

---

プロパティ リスト

• Caption

 Data Type: string
 Access Type: Read Only

Caption プロパティは、オブジェクトを短いテキスト (1 行の文字列) で表した説明です。

• CreationClassName

 Data Type: string
 Access Type: Read Only

CreationClassName は、インスタンスの作成で使用されるクラス名、またはサブクラス名を示します。このクラスのほかのキーのプロパティと一緒に使用すると、このクラスおよびそのサブクラスのインスタンスすべてがこのプロパティによって一意に識別されます。

• Description

 Data Type: string
 Access Type: Read Only

Description プロパティは、オブジェクトの説明を提供します。

• InstallDate

 Data Type: datetime
 Access Type: Read Only

InstallDate プロパティは、オブジェクトがいつインストールされたかを示す datetime 値です。値がなくても、オブジェクトがインストールされていないことを示すわけではありません。

• Length

 Data Type: real64
 Access Type: Read Only

物理リンクの現在の長さ (フィート) です。接続 (特にワイヤレス テクノロジ) によっては、このプロパティは適用されずに未初期化のままとなる場合があります。

• Manufacturer

 Data Type: string
 Access Type: Read Only

物理要素の生産に責任がある組織の名前です。これは要素の購入先のエンティティである可能性がありますが、true である必要はありません。後者の情報は CIM_Product の Vendor プロパティに含まれています。

• MaxLength

 Data Type: real64
 Access Type: Read Only

物理リンクの最大長 (フィート) です。

• MediaType

 Data Type: uint16
 Access Type: Read Only

MediaType プロパティにより、送信シグナルが通過するメディアの特別な種類が定義されます。共通ネットワーク メディアには、ツイストペア (値 = 11 または 12)、同軸 (7、8 または 9) および光ファイバー ケーブル (10) が含まれます。

• Model

 Data Type: string
 Access Type: Read Only

物理要素の一般的な認識名です。

• Name

 Data Type: string
 Access Type: Read Only

Name プロパティは、オブジェクトを認識するためのラベルを定義します。サブクラスでは、Name プロパティは上書きされて Key プロパティになることがあります。

• OtherIdentifyingInfo

 Data Type: string
 Access Type: Read Only

OtherIdentifyingInfo により、物理要素の識別に使用される追加データが資産タグ情報から得られます。資産タグもある要素に関連するバー コード データは 1 例です。バー コード データだけが利用可能で、要素キーとして使用されるために一意である場合、このプロパティは NULL で、タグ プロパティのクラス キーとして使用されるバー コード データであることに注意してください。

• PartNumber

 Data Type: string
 Access Type: Read Only

物理的要素の生産または製造に責任がある組織によって割り当てられた部品番号です。

• PoweredOn

 Data Type: boolean
 Access Type: Read Only

物理要素の電力がオン (TRUE) になるか、オフ (FALSE) になるかを示すブール値です。

• SerialNumber

 Data Type: string
 Access Type: Read Only

物理要素の認識に使用される製造元に割り当てられた番号です。

• SKU

 Data Type: string
 Access Type: Read Only

この物理要素の SKU 数です。

• Status

 Data Type: string
 Access Type: Read Only

Status プロパティはオブジェクトの現在の状態を示す文字列です。操作可能な状態および操作不可能な状態が定義されます。操作可能な状態は、"OK"、"低下" および "障害が発生する可能性あり" です。"障害が発生する可能性あり" は、要素は適切に機能するけれども近いうちに障害が発生する可能性があることを示します。例: SMART 対応ハード ディスク。操作不可能な状態も指定できます。これは、"エラー"、"開始中"、"停止動作中" および "サービス" です。最後の "サービス" には、ディスクがミラーされている間、ユーザーのアクセス許可の一覧を再度読み込む間、または他の管理用作業が行われている間などが該当します。この作業がすべてオンラインで行われるとは限りませんが、[管理要素] は "OK" でも他の状態でもありません。

• Tag

 Data Type: string
 Access Type: Read Only

物理要素を一意に認識し、要素のキーとして機能する任意の文字列です。Tag プロパティには、資産タグまたはシリアル番号データなどの情報を含めることができます。CIM_PhysicalElement のキーは、キャビネット、アダプターなどの物理的な位置に関係なく、ハードウェアまたはエンティティを識別するように、オブジェクトの階層構造で非常に高い位置にあります。たとえば、ホット スワップされる取り外しコンポーネントは、コンポーネントが含まれる (スコーピング) パッケージから取り外され、一時的に使用されなくなります。オブジェクトは､まだ存在します。別のスコープ コンテナーに挿入される可能性があります。このため、物理要素のキーは任意の文字列で、配置または場所指向階層によって独立して定義されます。

• Version

 Data Type: string
 Access Type: Read Only

物理要素のバージョンを示す文字列です。

• Wired

 Data Type: boolean
 Access Type: Read Only

物理リンクが実際のケーブル (TRUE) であるか、またはワイヤレス接続 (FALSE) であるかどうかを示すブール値です。

---

メソッド リスト

---

WQL サンプル (e.g. VB/PowerShell)

CIM_PhysicalLink

VB6/VBS
SWbemServicesクラスのExecQueryメソッドからWQLを実行可能です。
Set PrcSet = Service.ExecQuery("CIM_PhysicalLink")

VB.Net
ObjectQueryクラスのQueryStringプロパティにWQLを設定し、ManagementObjectSearcherクラスのGetメソッドからWQLを実行可能です。
Searcher.Query.QueryString = "CIM_PhysicalLink"
PrcSrc = Searcher.Get

PowerShell
Get-WmiObjectコマンドレットのqueryオプションを指定しWQLを実行可能です。
Get-WmiObject -query "CIM_PhysicalLink"

---

このサイトの情報について

このコンテンツはWMIの各コンポーネントが持っているCIM_PhysicalLinkクラス情報を参照・抽出しリファレンスとして作成・提供しています。
参照したWMIの名前空間はroot/CIMV2、参照OS環境はWindows 2000以降のOSを対象としております。

WMIの使い方(VB6, VBS, VBA, VB.NET, VC#, PowerShellを対象)に関してはWMI Stepも参考にしてみてください。(WMI初心者・入門編としてもおすすめです。)
各種言語を使用したWMIを使用するたたき台としてソーステンプレートも公開しています。プログラム/スクリプト作成時に役立てば…と思っています。

---