CIM_DataFile クラス

[アーティクル]
06/13/2023

CIM_DataFile クラスは、データまたは実行可能コードの名前付きコレクションを表します。ローカル固定ディスク上のファイルのインスタンスのみが返されます。

重要

DMTF (分散管理タスクフォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョンスキーマのみがサポートされています。

次の構文は、マネージドオブジェクトフォーマット (MOF) コードを簡素化しており、継承されたすべてのプロパティを含んでいます。プロパティは、MOF の順序ではなく、アルファベット順で一覧表示されます。

構文

[Dynamic, Provider("CIMWin32"), UUID("{8502C55A-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("All Files (CIM)"), AMENDMENT]
class CIM_DataFile : CIM_LogicalFile
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  boolean  Archive;
  boolean  Compressed;
  string   CompressionMethod;
  string   CreationClassName;
  datetime CreationDate;
  string   CSCreationClassName;
  string   CSName;
  string   Drive;
  string   EightDotThreeFileName;
  boolean  Encrypted;
  string   EncryptionMethod;
  string   Name;
  string   Extension;
  string   FileName;
  uint64   FileSize;
  string   FileType;
  string   FSCreationClassName;
  string   FSName;
  boolean  Hidden;
  uint64   InUseCount;
  datetime LastAccessed;
  datetime LastModified;
  string   Path;
  boolean  Readable;
  boolean  System;
  boolean  Writeable;
  string   Manufacturer;
  string   Version;
};

メンバー

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

メソッド
プロパティ

メソッド

CIM_DataFile クラスには、これらのメソッドがあります。

メソッド	説明
ChangeSecurityPermissions	オブジェクトパスで指定された論理ファイルのセキュリティアクセス許可を変更します。 WMI によって実装されます。
ChangeSecurityPermissionsEx	オブジェクトパスで指定された論理ファイルのセキュリティアクセス許可を変更します。 WMI によって実装されます。
圧縮	NTFS 圧縮を使用して、オブジェクトパスで指定された論理ファイル (またはディレクトリ) を圧縮します。 WMI によって実装されます。
CompressEx	オブジェクトパスで指定された論理ファイル (またはディレクトリ) を圧縮します。 WMI によって実装されます。
コピー	オブジェクトパスで指定された論理ファイル (またはディレクトリ) を、入力パラメーターで指定された場所にコピーします。 WMI によって実装されます。
CopyEx	オブジェクトパスで指定された論理ファイル (またはディレクトリ) を、入力パラメーターで指定された場所にコピーします。 WMI によって実装されます。
削除	オブジェクトパスで指定された論理ファイル (またはディレクトリ) を削除します。 WMI によって実装されます。
DeleteEx	オブジェクトパスで指定された論理ファイル (またはディレクトリ) を削除します。 WMI によって実装されます。
GetEffectivePermission	呼び出し元が Permission 引数で指定された集約されたアクセス許可を持っているかどうかを判断します。 WMI によって実装されます。
名前の変更	オブジェクトパスで指定された論理ファイル (またはディレクトリ) の名前を変更します。 WMI によって実装されます。
TakeOwnerShip	オブジェクトパスで指定された論理ファイルの所有権を取得します。 WMI によって実装されます。
TakeOwnerShipEx	オブジェクトパスで指定された論理ファイルの所有権を取得します。 WMI によって実装されます。
解凍	オブジェクトパスで指定された論理ファイル (またはディレクトリ) を圧縮解除します。 WMI によって実装されます。
CompressEx	オブジェクトパスで指定された論理ファイル (またはディレクトリ) を圧縮解除します。 WMI によって実装されます。

プロパティ

CIM_DataFile クラスには、これらのプロパティがあります。

AccessMask

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")、 DisplayName ("Access Rights")

ファイルに対する特定の操作にアクセスまたは実行するために必要なアクセス権を表すビットマスク。ビット値については、「 ファイルおよびディレクトリアクセス権限定数」を参照してください。

Note

FAT ボリュームでは、代わりに FULL_ACCESS 値が返されます。これは、オブジェクトにセキュリティが設定されていないことを示します。

このプロパティは、 CIM_LogicalFileから継承されます。

FILE_READ_DATA (ファイル) またはFILE_LIST_DIRECTORY (ディレクトリ) ( 1)

FILE_WRITE_DATA (ファイル) またはFILE_ADD_FILE (ディレクトリ) ( 2)

FILE_APPEND_DATA (ファイル) またはFILE_ADD_SUBDIRECTORY (ディレクトリ) ( 4)

FILE_READ_EA (8)

FILE_WRITE_EA (16)

FILE_EXECUTE (ファイル) またはFILE_TRAVERSE (ディレクトリ) ( 32)

FILE_DELETE_CHILD (ディレクトリ) (64)

FILE_READ_ATTRIBUTES (128)

FILE_WRITE_ATTRIBUTES (256)

DELETE (65536)

READ_CONTROL (131072)

WRITE_DAC (262144)

WRITE_OWNER (524288)

SYNCHRONIZE (1048576)

Archive

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")、 DisplayName ("Should be Archived")

True の場合は、ファイルをアーカイブする必要があります。

このプロパティは、 CIM_LogicalFileから継承されます。

Caption

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)、 DisplayName ("Caption")

オブジェクトの短いテキストの説明。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

Compressed

データ型: boolean
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")、 DisplayName ("Compressed")

True の場合、ファイルは圧縮されます。

このプロパティは、 CIM_LogicalFileから継承されます。

CompressionMethod

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Compression Method")

論理ファイルの圧縮に使用されるアルゴリズムまたはツールを示す自由形式の文字列。圧縮スキームが不明であるか、説明されていない場合は、"不明" を使用します。論理ファイルが圧縮されていても、圧縮スキームが不明であるか、説明されていない場合は、"Compressed" を使用します。論理ファイルが圧縮されていない場合は、"圧縮されていない" を使用します。

このプロパティは、 CIM_LogicalFileから継承されます。

CreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: CIM_Key、 DisplayName ("クラス名")

クラスの名前

このプロパティは、 CIM_LogicalFileから継承されます。

CreationDate

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: DisplayName ("作成日")

ファイルの作成日時。

このプロパティは、 CIM_LogicalFileから継承されます。

CSCreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: 伝達 ( "CIM_FileSystem。CSCreationClassName")、 CIM_Key、 DisplayName ("コンピューターシステムクラス名")

コンピューターシステムのクラス。

このプロパティは、 CIM_LogicalFileから継承されます。

CSName

データ型: string
アクセスの種類: 読み取り専用
修飾子: 伝達 ( "CIM_FileSystem。CSName")、 CIM_Key、 DisplayName ("コンピューターシステム名")

コンピューターシステムの名前。

このプロパティは、 CIM_LogicalFileから継承されます。

説明

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Description")

オブジェクトのテキスト説明。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

ドライブ

データ型: string
アクセスの種類: 読み取り専用
修飾子: 修正済み、 スキーマ ("Win32")、 DisplayName ("Drive")

ファイルのドライブ文字 (ドライブ文字の後のコロンを含む)。

例: "c:"

このプロパティは、 CIM_LogicalFileから継承されます。

EightDotThreeFileName

データ型: string
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")、 DisplayName ("8 ドット 3 ファイル名")

DOS 互換ファイル名。

例: "c:\progra~1"

このプロパティは、 CIM_LogicalFileから継承されます。

Encrypted

データ型: boolean
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")、 DisplayName ("Encrypted")

True の場合、ファイルは暗号化されます。

このプロパティは、 CIM_LogicalFileから継承されます。

EncryptionMethod

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Encryption Method")

論理ファイルの暗号化に使用されるアルゴリズムまたはツールを識別する自由形式の文字列。暗号化スキームが使用されていない場合 (セキュリティ上の理由など)、"不明" を使用します。ファイルが暗号化されていても、その暗号化スキームが不明であるか、開示されていない場合は、"Encrypted" を使用します。論理ファイルが暗号化されていない場合は、"Not Encrypted" を使用します。

このプロパティは、 CIM_LogicalFileから継承されます。

拡張子

データ型: string
アクセスの種類: 読み取り専用
修飾子: 修正済み、 スキーマ ("Win32")、 DisplayName ("ファイル拡張子")

前のピリオド (ドット) のないファイル名拡張子。

例: "txt"、"mof"、"mdb"

このプロパティは、 CIM_LogicalFileから継承されます。

FileName

データ型: string
アクセスの種類: 読み取り専用
修飾子: 修正済み、 スキーマ ("Win32")、 DisplayName ("ファイル名")

ファイル名拡張子のないファイル名。例: "MyDataFile"

このプロパティは、 CIM_LogicalFileから継承されます。

FileSize

データ型: uint64
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Size")、 Units ("bytes")

ファイルのサイズです (バイト単位)。

スクリプトでの uint64 値の使用の詳細については、「 WMI でのスクリプト作成」を参照してください。

このプロパティは、 CIM_LogicalFileから継承されます。

FileType

データ型: string
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")、 DisplayName ("File Type")

Extension プロパティによって示されるファイルの種類を表す記述子。

このプロパティは、 CIM_LogicalFileから継承されます。

FSCreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: 伝達 ( "CIM_FileSystem。CreationClassName")、 CIM_Key、 DisplayName ("File System Class Name")

ファイルシステムのクラス。

このプロパティは、 CIM_LogicalFileから継承されます。

FSName

データ型: string
アクセスの種類: 読み取り専用
修飾子: 伝達 ( "CIM_FileSystem。Name")、 CIM_Key、 DisplayName ("File System Name")

ファイルシステムの名前。

このプロパティは、 CIM_LogicalFileから継承されます。

[非表示]

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")、 DisplayName ("Hidden")

True の場合、ファイルは非表示になります。

このプロパティは、 CIM_LogicalFileから継承されます。

InstallDate

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")

オブジェクトがインストールされた日時を示します。値がない場合、オブジェクトがインストールされていないことを示すわけではありません。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

InUseCount

データ型: uint64
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Current File Open Count")

ファイルに対して現在アクティブな "ファイルが開く" の数。

スクリプトでの uint64 値の使用の詳細については、「 WMI でのスクリプト作成」を参照してください。

このプロパティは、 CIM_LogicalFileから継承されます。

LastAccessed

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Last Accessed")

ファイルが最後にアクセスされた日時。

このプロパティは、 CIM_LogicalFileから継承されます。

Lastmodified

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Last Modified")

ファイルが最後に変更された日付と時刻。

このプロパティは、 CIM_LogicalFileから継承されます。

Manufacturer

データ型: string
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")、 DisplayName ("Manufacturer")

バージョンリソースの製造元の文字列 (存在する場合)。

名前

データ型: string
アクセスの種類: 読み取り専用
修飾子: キー

Name プロパティは、ファイルシステム内の論理ファイルインスタンスのキーとして機能する継承された名前を表す文字列です。完全なパス名を指定する必要があります。

例: C:\Windows\system\win.ini

このプロパティは、 CIM_LogicalFileから継承されます。

パス

データ型: string
アクセスの種類: 読み取り専用
修飾子: 修正済み、 スキーマ ("Win32")、 DisplayName ("Path")

先頭と末尾の円記号を含むファイルのパス。例: "\windows\system\"

このプロパティは、 CIM_LogicalFileから継承されます。

読みやすい

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Readable")

True の場合、ファイルを読み取ることができます。

このプロパティは、 CIM_LogicalFileから継承されます。

状態

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (10)、 DisplayName ("Status")

オブジェクトの現在の状態を示す文字列。運用状態と非運用状態を定義できます。操作状態には、"OK"、"低下"、"事前失敗" が含まれます。 "Pred Fail" は、要素が正しく機能しているが、エラー (SMART 対応ハードディスクドライブなど) を予測していることを示します。

非運用状態には、"エラー"、"開始中"、"停止中"、"サービス" が含まれる場合があります。 "サービス" は、ディスクのミラー、ユーザーのアクセス許可リストの再読み込み、またはその他の管理作業中に適用できます。このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

次の値があります。

OK ("OK")

エラー ("Error")

機能低下 ("Degraded")

不明 ("不明")

Pred Fail ("Pred Fail")

開始 ("開始")

停止中 ("停止中")

サービス ("Service")

ストレス ( "ストレス")

NonRecover ("NonRecover")

連絡先なし ("連絡先なし")

Lost Comm ("Lost Comm")

システム

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")、 DisplayName ("System File")

True の場合、ファイルはシステムファイルです。

このプロパティは、 CIM_LogicalFileから継承されます。

Version

データ型: string
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")、 DisplayName ("Version")

バージョンリソースのバージョン文字列 (存在する場合)。

書き込み可能

データ型: boolean
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Writeable")

True の場合、ファイルを書き込むことができます。

このプロパティは、 CIM_LogicalFileから継承されます。

解説

CIM_DataFile クラスは、CIM_LogicalFileから派生します。

WMI は、 CIM_DataFile クラスとそのすべてのメソッドを実装します。 CIM_DataFile クラスは動的クラスです。

このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。

セキュリティ上の理由から、WMI はリモートコンピューターの呼び出しを直接サポートせず、ファイルをそれ自体にコピーするように指示します。ただし、関連するプログラミング言語を使用して、FTP や RoboCopy などを呼び出すことができます。

例

次のスクリプトセンターのコード例では、Powershell を使用して Exchange 環境レポートを生成するために、大規模なアプリケーションの一部として CIM_DataFile クラスを使用します。

TechNet ギャラリーの WMI PowerShell を使用したファイルの検索コードサンプルでは、 CIM_DataFile を使用して、複数のコンピューター間で 1 つ以上のファイルを検索します。

次の VBS コードサンプルでは、データファイルで標準のワイルドカード検索を実行する方法について説明します。円記号区切り記号は、別の円記号 (\\) でエスケープする必要があることに注意してください。また、"CIM_DataFile" を使用する場合は。WHERE 句の FileName" では、WMIPRVSE プロセスによって、使用可能なすべてのストレージデバイス上のすべてのディレクトリがスキャンされます。これは、特にリモート共有をマップしていて、ウイルス対策の警告をトリガーできる場合に、しばらく時間がかかる場合があります。

strComputer = "."
Set objWMIService = GetObject("winmgmts:" & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFiles = objWMIService.ExecQuery("Select * from CIM_DataFile where FileName Like '%~%'")
For Each objFile in colFiles
   Wscript.Echo objFile.Name
Next

次のスニペットでは、検索範囲を特定のドライブ、パス、ファイル拡張子に制限します。

Set colFiles = objWMIService.ExecQuery("Select * from CIM_DataFile where Drive='"C:"' And Path='"\\"' and Name Like '%~%' and Extension='doc' ")

次の PowerShell コードサンプルでは、1 つの属性値を取得します。

 $computer = "."

  $path = "C:\\Program Files\\Microsoft SQL Server\\MSSQL.1\\MSSQL\\LOG\\"

  $filename = "ERRORLOG"

  $fullname = $path + $filename

  $wql = 'SELECT Archive FROM CIM_DataFile WHERE Name = "' + $fullname + '"'


  Get-WmiObject -ComputerName $computer -Query $wql | foreach { $_.Archive }

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

次の方法で共有

CIM_DataFile クラス

構文

メンバー

メソッド

プロパティ

解説

例

要件

関連項目

フィードバック

その他のリソース