CIM_DataFile-Klasse

Artikel
06/13/2023

Die CIM_DataFile-Klasse stellt eine benannte Sammlung von Daten oder ausführbarem Code dar. Es werden nur Instanzen von Dateien auf lokalen Festplatten zurückgegeben.

Wichtig

Die CIM-Klassen (Common Information Model) von DMTF (Distributed Management Task Force) sind die übergeordneten Klassen, auf denen WMI-Klassen erstellt werden. WMI unterstützt derzeit nur die CIM 2.x-Versionsschemas.

Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

[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;
};

Member

Die CIM_DataFile-Klasse verfügt über die folgenden Membertypen:

Methoden
Eigenschaften

Methoden

Die CIM_DataFile-Klasse verfügt über diese Methoden.

Methode	BESCHREIBUNG
ChangeSecurityPermissions	Ändert die Sicherheitsberechtigungen für die logische Datei, die im Objektpfad angegeben ist. Wird von WMI implementiert.
ChangeSecurityPermissionsEx	Ändert die Sicherheitsberechtigungen für die logische Datei, die im Objektpfad angegeben ist. Wird von WMI implementiert.
Komprimieren	Verwendet die NTFS-Komprimierung, um die logische Datei (oder das Verzeichnis) zu komprimieren, die im Objektpfad angegeben ist. Wird von WMI implementiert.
CompressEx	Komprimiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Wird von WMI implementiert.
Kopieren	Kopiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist, an den vom Eingabeparameter angegebenen Speicherort. Wird von WMI implementiert.
CopyEx	Kopiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist, an den vom Eingabeparameter angegebenen Speicherort. Wird von WMI implementiert.
Löschen	Löscht die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Wird von WMI implementiert.
DeleteEx	Löscht die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Wird von WMI implementiert.
GetEffectivePermission	Bestimmt, ob der Aufrufer über die durch das Permission-Argument angegebenen aggregierten Berechtigungen verfügt. Wird von WMI implementiert.
Umbenennen	Benennt die logische Datei (oder das Verzeichnis) um, die im Objektpfad angegeben ist. Wird von WMI implementiert.
TakeOwnerShip	Ruft den Besitz der logischen Datei ab, die im Objektpfad angegeben ist. Wird von WMI implementiert.
TakeOwnerShipEx	Ruft den Besitz der logischen Datei ab, die im Objektpfad angegeben ist. Wird von WMI implementiert.
Dekomprimieren	Entpackt die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Wird von WMI implementiert.
UncompressEx	Entpackt die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Wird von WMI implementiert.

Eigenschaften

Die CIM_DataFile-Klasse verfügt über diese Eigenschaften.

Accessmask

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32"), DisplayName ("Zugriffsrechte")

Bitmaske, die die Zugriffsrechte darstellt, die für den Zugriff auf die Datei oder die Ausführung bestimmter Vorgänge für die Datei erforderlich sind. Bitwerte finden Sie unter Konstanten für Datei- und Verzeichniszugriffsrechte.

Hinweis

Auf FAT-Volumes wird stattdessen der wert FULL_ACCESS zurückgegeben, was angibt, dass keine Sicherheit für das Objekt festgelegt wurde.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

FILE_READ_DATA (Datei) oder FILE_LIST_DIRECTORY (Verzeichnis) (1)

FILE_WRITE_DATA (Datei) oder FILE_ADD_FILE (Verzeichnis) (2)

FILE_APPEND_DATA (Datei) oder FILE_ADD_SUBDIRECTORY (Verzeichnis) (4)

FILE_READ_EA (8)

FILE_WRITE_EA (16)

FILE_EXECUTE (Datei) oder FILE_TRAVERSE (Verzeichnis) (32)

FILE_DELETE_CHILD (Verzeichnis) (64)

FILE_READ_ATTRIBUTES (128)

FILE_WRITE_ATTRIBUTES (256)

DELETE (65536)

READ_CONTROL (131072)

WRITE_DAC (262144)

WRITE_OWNER (524288)

SYNCHRONISIEREN (1048576)

Archivieren

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32"), DisplayName ("Sollte archiviert werden")

Wenn True, sollte die Datei archiviert werden.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Caption

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (64), DisplayName ("Caption")

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Compressed

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32"), DisplayName ("Compressed")

True gibt an, dass die Datei komprimiert wird.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

CompressionMethod

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Compression Method")

Freiformzeichenfolge, die den Algorithmus oder das Tool zum Komprimieren der logischen Datei angibt. Wenn das Komprimierungsschema unbekannt oder nicht beschrieben ist, verwenden Sie "Unbekannt". Wenn die logische Datei komprimiert ist, das Komprimierungsschema jedoch unbekannt oder nicht beschrieben ist, verwenden Sie "Komprimiert". Wenn die logische Datei nicht komprimiert ist, verwenden Sie "Nicht komprimiert".

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

CreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: CIM_Key, DisplayName ("Klassenname")

Name der Klasse.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

CreationDate

Datentyp: datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Erstellungsdatum")

Datum und Uhrzeit der Erstellung der Datei.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

CSCreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Propagiert ("CIM_FileSystem. CSCreationClassName"), CIM_Key, DisplayName ("Computer System Class Name")

Klasse des Computersystems.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

CSName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Propagiert ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("Computersystemname")

Name des Computersystems.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Beschreibung

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Description")

Eine Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Laufwerk

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Behoben, Schema ("Win32"), DisplayName ("Drive")

Laufwerkbuchstabe (einschließlich des Doppelpunkts, der auf den Laufwerkbuchstaben folgt) der Datei.

Beispiel: "c:"

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

EightDotThreeFileName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32"), DisplayName ("Eight Dot Three File Name")

DOS-kompatibler Dateiname.

Beispiel: "c:\progra~1"

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Verschlüsselt

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32"), DisplayName ("Encrypted")

True gibt an, dass die Datei verschlüsselt ist.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Encryptionmethod

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Encryption Method")

Freiformzeichenfolge, die den Algorithmus oder das Tool zum Verschlüsseln einer logischen Datei identifiziert. Wenn das Verschlüsselungsschema nicht verwendet wird (z. B. aus Sicherheitsgründen), verwenden Sie "Unbekannt". Wenn die Datei verschlüsselt ist, aber entweder ihr Verschlüsselungsschema unbekannt oder nicht offengelegt ist, verwenden Sie "Encrypted". Wenn die logische Datei nicht verschlüsselt ist, verwenden Sie "Not Encrypted".

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Erweiterung

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Behoben, Schema ("Win32"), DisplayName ("Dateierweiterung")

Dateinamenerweiterung ohne den vorherigen Punkt (Punkt).

Beispiel: "txt", "mof", "mdb"

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

FileName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Behoben, Schema ("Win32"), DisplayName ("Dateiname")

Dateiname ohne Dateinamenerweiterung. Beispiel: "MyDataFile"

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

FileSize

Datentyp: uint64
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Size"), Units ("Bytes")

Größe der Datei in Bytes.

Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

FileType

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32"), DisplayName ("Dateityp")

Deskriptor, der den durch die Extension-Eigenschaft angegebenen Dateityp darstellt.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

FSCreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Propagiert ("CIM_FileSystem. CreationClassName"), CIM_Key, DisplayName ("Dateisystemklassenname")

Klasse des Dateisystems.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

FSName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Propagiert ("CIM_FileSystem. Name"), CIM_Key, DisplayName ("Dateisystemname")

Name des Dateisystems.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Hidden

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32"), DisplayName ("Hidden")

True gibt an, dass die Datei ausgeblendet ist.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

InstallDate

Datentyp: datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")

Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts gibt nicht an, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InUseCount

Datentyp: uint64
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Anzahl der aktuellen Geöffneten Dateien")

Anzahl der "Datei öffnet", die derzeit für die Datei aktiv sind.

Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

LastAccessed

Datentyp: datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Letzter Zugriff")

Datum und Uhrzeit des letzten Zugriffs auf die Datei.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Lastmodified

Datentyp: datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Last Modified")

Datum und Uhrzeit der letzten Änderung der Datei.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Manufacturer

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32"), DisplayName ("Manufacturer")

Herstellerzeichenfolge aus der Versionsressource (sofern vorhanden).

Name

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schlüssel

Die Name-Eigenschaft ist eine Zeichenfolge, die den geerbten Namen darstellt, der als Schlüssel einer logischen Datei instance innerhalb eines Dateisystems dient. Vollständige Pfadnamen sollten angegeben werden.

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

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Pfad

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Behoben, Schema ("Win32"), DisplayName ("Path")

Pfad der Datei einschließlich der führenden und nachfolgenden umgekehrten Schrägstriche. Beispiel: "\windows\system\"

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Lesbar

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Lesbar")

True gibt an, dass die Datei gelesen werden kann.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Status

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (10), DisplayName ("Status")

Zeichenfolge, die die aktuelle status des Objekts angibt. Operative und nicht operative status können definiert werden. Operative status können "OK", "Degraded" und "Pred Fail" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. eine SMART-fähige Festplatte).

Nicht betriebsbereite status können "Error", "Starting", "Stopping" und "Service" enthalten. "Dienst" kann während der Datenträger-Spiegel-Resilvering, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben angewendet werden. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Wird gestartet ("Wird gestartet")

Beenden ("Wird beendet")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

System

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32"), DisplayName ("Systemdatei")

Bei True handelt es sich bei der Datei um eine Systemdatei.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Version

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schema ("Win32"), DisplayName ("Version")

Versionszeichenfolge aus der Versionsressource (sofern vorhanden).

Schreibbar

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Writeable")

True gibt an, dass die Datei geschrieben werden kann.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Bemerkungen

Die CIM_DataFile-Klasse wird von CIM_LogicalFile abgeleitet.

WMI implementiert die CIM_DataFile-Klasse und alle ihre Methoden. Die CIM_DataFile-Klasse ist eine dynamische Klasse.

Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die von der DMTF veröffentlicht werden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu korrigieren, den Microsoft SDK-Dokumentationsstandards zu entsprechen oder weitere Informationen bereitzustellen.

Aus Sicherheitsgründen unterstützt WMI nicht direkt den Aufruf eines Remotecomputers und weist ihn an, Dateien auf sich selbst zu kopieren. Sie können jedoch die entsprechende Programmiersprache verwenden, um beispielsweise FTP oder RoboCopy aufzurufen.

Beispiele

Im folgenden Codebeispiel des Skriptcenters wird eine CIM_DataFile-Klasse als Teil einer größeren Anwendung verwendet, um Exchange-Umgebungsberichte mithilfe von PowerShell zu generieren.

Im PowerShell-Codebeispiel "Dateien mit WMI suchen" im TechNet-Katalog wird eine CIM_DataFile verwendet, um auf mehreren Computern nach einer oder mehreren Dateien zu suchen.

Im folgenden VBS-Codebeispiel wird beschrieben, wie eine Standardmäßige Wildcardsuche für eine Datendatei ausgeführt wird. Beachten Sie, dass die Umgekehrten Schrägstrichtrennzeichen mit einem anderen umgekehrten Schrägstrich (\\) mit Escapezeichen versehen werden müssen. Auch bei Verwendung von "CIM_DataFile. FileName" in der WHERE-Klausel überprüft der WMIPRVSE-Prozess alle Verzeichnisse auf jedem verfügbaren Speichergerät. Dies kann einige Zeit in Anspruch nehmen, insbesondere wenn Sie Remotefreigaben zugeordnet haben und Antivirenwarnungen auslösen können.

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

Der folgende Codeausschnitt beschränkt den Suchbereich auf ein bestimmtes Laufwerk, einen bestimmten Pfad und eine bestimmte Dateierweiterung.

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

Im folgenden PowerShell-Codebeispiel wird ein einzelner Attributwert abgerufen.

 $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 }

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

CIM_LogicalFile
WMI-Aufgaben: Dateien und Ordner
Datei- und Verzeichniszugriffsrechtkonstanten

Freigeben über

CIM_DataFile-Klasse

Syntax

Member

Methoden

Eigenschaften

Bemerkungen

Beispiele

Anforderungen

Siehe auch

Feedback

Zusätzliche Ressourcen