CIM_DataFile クラス
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 |
|
[DLL] |
|