CIM _ データファイルクラス

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

重要

DMTF (Distributed Management Task Force) CIM (Common Information Model) クラスは、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 _ データファイル クラスには、次の種類のメンバーがあります。

メソッド

CIM _ データファイル クラスには、これらのメソッドがあります。

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

プロパティ

CIM _ データファイル クラスには、これらのプロパティがあります。

AccessMask

データ型: uint32

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

修飾子: Schema ("Win32")、 DisplayName ("アクセス権")

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

注意

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

このプロパティは CIM _ logicalfileから継承されます。

ファイル __データの読み取り (ファイル) またはファイルの _ 一覧の _ ディレクトリ (ディレクトリ) (1)

ファイル __データの書き込み (ファイル) またはファイルの _ 追加 ( _ ディレクトリ) (2)

ファイル _追加 _ データ (ファイル) またはファイル _ 追加 _ サブディレクトリ (ディレクトリ) (4)

ファイル __EA の読み取り(8)

ファイル __EA の書き込み(16)

ファイル _実行 (ファイル) またはファイルの _ 走査 (ディレクトリ) (32)

ファイル __子 (ディレクトリ) の削除(64)

ファイル __属性の読み取り(128)

ファイル __属性の書き込み(256)

削除 (65536)

読み取り _コントロール (131072)

書き込み _DAC (262144)

書き込み _所有者 (524288)

同期 (1048576)

Archive

データ型: ブール値

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

修飾子: Schema ("Win32")、 DisplayName ("アーカイブが必要")

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

このプロパティは CIM _ logicalfileから継承されます。

Caption

データ型: 文字列

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

修飾子: MaxLen (64)、 DisplayName ("Caption")

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

このプロパティは CIM _ ManagedSystemElementから継承されます。

Compressed

データ型: ブール値

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

修飾子:スキーマ("Win32")、DisplayName ("Compressed")

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

このプロパティは CIM _ LogicalFile から継承されます

CompressionMethod

データ型: 文字列

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

修飾子: DisplayName ("Compression Method")

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

このプロパティは CIM _ LogicalFile から継承されます

CreationClassName

データ型: 文字列

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

修飾子: CIM _キー 、DisplayName ("クラス名")

クラスの名前

このプロパティは CIM _ LogicalFile から継承されます

CreationDate

データ型: datetime

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

修飾子: DisplayName ("作成日")

ファイルの作成日時。

このプロパティは CIM _ LogicalFile から継承されます

CSCreationClassName

データ型: 文字列

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

修飾子: 反映 ("CIM _ FileSystem)。CSCreationClassName")、CIM _ キー 、DisplayName ("コンピューター システム クラス名")

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

このプロパティは CIM _ LogicalFile から継承されます

CSName

データ型: 文字列

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

修飾子: 反映 ("CIM _ FileSystem)。CSName")、CIM _ キー 、DisplayName ("コンピューター システム名")

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

このプロパティは CIM _ LogicalFile から継承されます

説明

データ型: 文字列

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

修飾子: DisplayName ("Description")

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

このプロパティは CIM _ ManagedSystemElement から継承されます

ドライブ

データ型: 文字列

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

修飾子:固定 、スキーマ("Win32")、DisplayName ("Drive")

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

例: "c:"

このプロパティは CIM _ LogicalFile から継承されます

EightDotThreeFileName

データ型: 文字列

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

修飾子:スキーマ("Win32")、DisplayName ("Eight Dot Three File Name")

DOS と互換性のあるファイル名。

例: "c: \ progra~1"

このプロパティは CIM _ LogicalFile から継承されます

Encrypted

データ型: ブール値

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

修飾子:スキーマ("Win32")、DisplayName ("Encrypted")

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

このプロパティは CIM _ LogicalFile から継承されます

EncryptionMethod

データ型: 文字列

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

修飾子: DisplayName ("Encryption Method")

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

このプロパティは CIM _ LogicalFile から継承されます

拡張子

データ型: 文字列

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

修飾子:固定 、スキーマ("Win32")、DisplayName ("ファイル拡張子")

前のピリオドを含むファイル名の拡張子 (ドット)。

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

このプロパティは CIM _ LogicalFile から継承されます

FileName

データ型: 文字列

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

修飾子:固定 、スキーマ("Win32")、DisplayName ("ファイル名")

ファイル名に拡張子を付けずに指定します。 例: "MyDataFile"

このプロパティは CIM _ LogicalFile から継承されます

FileSize

データ型: uint64

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

修飾子: DisplayName ("Size")、 単位 ("bytes")

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

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

このプロパティは CIM _ LogicalFile から継承されます

FileType

データ型: 文字列

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

修飾子:スキーマ("Win32")、DisplayName ("ファイルの種類")

Extension プロパティで示されるファイルの種類を表 記述子。

このプロパティは CIM _ LogicalFile から継承されます

FSCreationClassName

データ型: 文字列

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

修飾子:伝達され _た ("CIM ファイルシステム"CreationClassName")、 CIM _ キーDisplayName (" ファイルシステムクラス名 ")

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

このプロパティは CIM _ logicalfileから継承されます。

FSName

データ型: 文字列

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

修飾子:伝達され _た ("CIM ファイルシステム"Name")、 CIM _ KeyDisplayName (" ファイルシステム名 ")

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

このプロパティは CIM _ logicalfileから継承されます。

[非表示]

データ型: ブール値

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

修飾子: Schema ("Win32")、 DisplayName ("Hidden")

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

このプロパティは CIM _ logicalfileから継承されます。

InstallDate

データ型: datetime

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

修飾子: Mappingstrings ("MIF"DMTF | ComponentID | 001.5 ")、 DisplayName (" インストール日 ")

オブジェクトがいつインストールされたかを示します。 値が不足している場合は、そのオブジェクトがインストールされていないことを示しています。

このプロパティは CIM _ ManagedSystemElementから継承されます。

InUseCount

データ型: uint64

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

修飾子: DisplayName ("現在のファイルのオープン数")

ファイルに対して現在アクティブな "ファイルが開かれています" の数。

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

このプロパティは CIM _ logicalfileから継承されます。

LastAccessed

データ型: datetime

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

修飾子: DisplayName ("最終アクセス")

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

このプロパティは CIM _ logicalfileから継承されます。

LastModified

データ型: datetime

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

修飾子: DisplayName ("Last Modified")

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

このプロパティは CIM _ logicalfileから継承されます。

Manufacturer

データ型: 文字列

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

修飾子: Schema ("Win32")、 DisplayName ("Manufacturer")

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

名前

データ型: 文字列

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

修飾子: キー

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

例: C: \ Windows \ システム \win.ini

このプロパティは CIM _ logicalfileから継承されます。

パス

データ型: 文字列

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

修飾子: FixedSchema ("Win32")、 DisplayName ("Path")

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

このプロパティは CIM _ logicalfileから継承されます。

できる

データ型: ブール値

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

修飾子: DisplayName ("読み取り可能")

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

このプロパティは CIM _ logicalfileから継承されます。

状態

データ型: 文字列

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

修飾子: MaxLen (10)、 DisplayName ("Status")

オブジェクトの現在の状態を示す文字列。 動作状態と非動作状態を定義できます。 動作状態には、"OK"、"低下"、および "Pred Fail" を含めることができます。 "Pred Fail" は、要素が適切に機能していることを示しますが、エラー (たとえば、スマート対応のハードディスクドライブ) を予測しています。

操作不可能な状態には、"エラー"、"開始"、"停止"、および "サービス" を含めることができます。 "サービス" は、ディスクのミラー化を再実行するとき、ユーザーのアクセス許可リストを再読み込みするとき、またはその他の管理作業を行うときに適用できます。 このような作業のすべてがオンラインであるとは限りませんが、マネージ要素は "OK" でも他の状態でもありません。

このプロパティは CIM _ ManagedSystemElementから継承されます。

次の値があります。

OK ("OK")

エラー ("error")

低下 ("低下")

不明 ("不明")

Pred fail ("Pred fail")

開始 ("開始中")

停止 ("停止")

サービス ("サービス")

負荷 ("ストレス")

非復旧 ("非復旧")

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

失わ れた通信 ("失われた通信")

システム

データ型: ブール値

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

修飾子: Schema ("Win32")、 DisplayName ("System File")

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

このプロパティは CIM _ logicalfileから継承されます。

Version

データ型: 文字列

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

修飾子: Schema ("Win32")、 DisplayName ("Version")

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

書き込み可能

データ型: ブール値

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

修飾子: DisplayName ("書き込み可能")

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

このプロパティは CIM _ logicalfileから継承されます。

解説

Cim _ データ ファイルクラスは cim _ logicalfileから派生します。

WMI は CIM _ データファイル クラスとそのすべてのメソッドを実装します。 CIM _ データファイル クラスは動的クラスです。

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

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

次のスクリプトセンターの コード例 では、大規模なアプリケーションの一部として CIM _ データファイル クラスを使用して、Powershell を使用して exchange 環境レポートを生成します。

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

次の VBS コードサンプルは、データファイルに対して標準のワイルドカード検索を実行する方法を示しています。 バックスラッシュ区切り記号は、別の円記号 () でエスケープする必要があることに注意してください \ \ 。 また、"CIM _ データファイル" を使用する場合も同様です。FileName"WHERE 句の 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
名前空間
ルート \ CIMV2
MOF
CIMWin32
[DLL]
CIMWin32.dll

関連項目

CIM _ logicalfile

WMI タスク: ファイルとフォルダー

ファイルとディレクトリのアクセス権の定数