CIM_DataFile-Klasse
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
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 |
|
| DLL |
|
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für