_CIM-Klasse "DeviceFile"
Die CIM _ DeviceFile-Klasse stellt einen Typ einer logischen Datei dar, die ein Gerät darstellt. Diese Konvention ist nützlich für Betriebssysteme, die Geräte mithilfe eines Bytestream-E/A-Modells verwalten. Das logische Gerät, das dieser Datei zugeordnet ist, wird mithilfe der _ CIM-Beziehung DeviceAccessedByFile angegeben.
Wichtig
Die CIM-Klassen (Distributed Management Task Force) (DMTF) (Common Information Model) 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
[Abstract, UUID("{4333BD60-E3D1-11d2-8601-0000F8102E5F}"), AMENDMENT]
class CIM_DeviceFile : CIM_LogicalFile
{
uint32 AccessMask;
boolean Archive;
string Caption;
boolean Compressed;
string CompressionMethod;
string CreationClassName;
datetime CreationDate;
string CSCreationClassName;
string CSName;
string Description;
string Drive;
string EightDotThreeFileName;
boolean Encrypted;
string EncryptionMethod;
string Extension;
string FileName;
uint64 FileSize;
string FileType;
string FSCreationClassName;
string FSName;
boolean Hidden;
datetime InstallDate;
uint64 InUseCount;
datetime LastAccessed;
datetime LastModified;
string Name;
string Path;
boolean Readable;
string Status;
boolean System;
boolean Writeable;
};
Member
Die CIM _ DeviceFile-Klasse verfügt über die folgenden Membertypen:
Methoden
Die CIM _ DeviceFile-Klasse verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| ChangeSecurityPermissions | Ändert die Sicherheitsberechtigungen für die logische Datei, die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| ChangeSecurityPermissionsEx | Ändert die Sicherheitsberechtigungen für die logische Datei, die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| Komprimieren | Komprimiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| CompressEx | Komprimiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| Kopieren | Kopiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist, an den vom Eingabeparameter angegebenen Speicherort. Nicht von WMI implementiert. |
| CopyEx | Kopiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist, an den vom Eingabeparameter angegebenen Speicherort. Nicht von WMI implementiert. |
| Löschen | Löscht die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| DeleteEx | Löscht die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| GetEffectivePermission | Bestimmt, ob der Aufrufer über die durch das Permission-Argument angegebenen aggregierten Berechtigungen verfügt. Nicht von WMI implementiert. |
| Umbenennen | Benennt die logische Datei (oder das Verzeichnis) um, die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| TakeOwnerShip | Erhält den Besitz der logischen Datei, die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| TakeOwnerShipEx | Erhält den Besitz der logischen Datei, die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| Dekomprimieren | Dekomprimiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| UncompressEx | Dekomprimiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
Eigenschaften
Die CIM _ DeviceFile-Klasse verfügt über diese Eigenschaften.
-
Accessmask
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32"), DisplayName ("Zugriffsrechte")
Bitarray, das die Zugriffsrechte für die bestimmte Datei oder das Verzeichnis darstellt, die bzw. das vom Benutzer oder der Gruppe gehalten wird, in dessen Namen die Instanz zurückgegeben wird. Auf FAT-Volumes wird FULL _ ACCESS zurückgegeben, was darauf hinweist, 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)
-
Gewährt das Recht, Daten aus der Datei zu lesen. Bei einem Verzeichnis gewährt dieser Wert das Recht, den Inhalt des Verzeichnisses auflisten zu können.
-
FILE _ WRITE _ DATA (Datei) oder FILE _ ADD FILE _ (Verzeichnis) (2)
-
Gewährt das Recht, Daten in die Datei zu schreiben. Für ein Verzeichnis gewährt dieser Wert das Recht, eine Datei im Verzeichnis zu erstellen.
-
FILE _ APPEND _ DATA (Datei) oder FILE _ ADD _ SUBDIRECTORY (Verzeichnis) (4)
-
Gewährt das Recht, Daten an die Datei anfügen. Für ein Verzeichnis gewährt dieser Wert das Recht, ein Unterverzeichnis zu erstellen.
-
FILE _ READ _ EA (8)
-
Gewährt das Recht, erweiterte Attribute zu lesen.
-
FILE _ WRITE _ EA (16)
-
Gewährt das Recht, erweiterte Attribute zu schreiben.
-
FILE _ EXECUTE (File) oder FILE _ TRAVERSE (Verzeichnis) (32)
-
Gewährt das Recht, eine Datei auszuführen. Für ein Verzeichnis kann das Verzeichnis durchlaufen werden.
-
FILE _ DELETE _ CHILD (Verzeichnis) (64)
-
Gewährt das Recht, ein Verzeichnis und alle dateien zu löschen, die es enthält (seine unteren Elemente), auch wenn die Dateien schreibgeschützt sind.
-
FILE _ LESEN _ VON ATTRIBUTEN (128)
-
Gewährt das Recht, Dateiattribute zu lesen.
-
FILE _ WRITE _ ATTRIBUTES (256)
-
Gewährt das Recht, Dateiattribute zu ändern.
-
DELETE (65536)
-
Gewährt Löschzugriff.
-
READ _ CONTROL (131072)
-
Gewährt Lesezugriff auf den Sicherheitsdeskriptor und Besitzer.
-
WRITE _ DAC (262144)
-
Gewährt Schreibzugriff auf die abhängige Zugriffssteuerungsliste.
-
WRITE _ OWNER (524288)
-
Weist den Schreibbesitzer zu.
-
SYNCHRONIZE (1048576)
-
Synchronisiert den Zugriff und ermöglicht einem Prozess, auf den Eintritt eines Objekts in den signalisierten Zustand zu warten.
Archivieren
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32"), DisplayName ("Sollte archiviert werden")
True gibt an, dass die Datei archiviert werden soll.
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
Caption
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64), DisplayName ("Caption")
Kurze Textbeschreibung des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
Compressed
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32"), DisplayName ("komprimiert")
True gibt an, dass die Datei komprimiert wird.
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
CompressionMethod
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Komprimierungsmethode")
Freiformzeichenfolge, die den Algorithmus oder das Tool zum Komprimieren der logischen Datei angibt. Wenn das Komprimierungsschema unbekannt oder nicht beschrieben ist, verwenden Sie "Unknown". Wenn die logische Datei komprimiert ist, das Komprimierungsschema jedoch unbekannt oder nicht beschrieben ist, verwenden Sie "Compressed". Wenn die logische Datei nicht komprimiert ist, verwenden Sie "Nicht komprimiert".
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
CreationClassName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: _ CIM-Schlüssel, DisplayName ("Klassenname")
Name der Klasse.
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
CreationDate
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Erstellungsdatum")
Erstellungsdatum der Datei.
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
CSCreationClassName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Weitergegeben ("CIM _ FileSystem.CSCreationClassName), _ CIM-Schlüssel, DisplayName ("Computersystemklassenname")
Klasse des Computersystems.
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
CSName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Weitergegeben ("CIM _ FileSystem.CSName"), _ CIM-Schlüssel, DisplayName ("Computersystemname")
Name des Computersystems.
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
Beschreibung
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Beschreibung")
Textbeschreibung des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
Laufwerk
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Behoben:, Schema ("Win32"), DisplayName ("Laufwerk")
Laufwerkbuchstabe (einschließlich des Doppelpunkts, der auf den Laufwerkbuchstaben folgt) der Datei. Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
Beispiel: "c:"
EightDotThreeFileName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32"), DisplayName ("Acht Punkte drei Dateiname")
DOS-kompatibler Dateiname für die Datei. Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
Beispiel: "c: \ progra~1"
Verschlüsselt
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32"), DisplayName ("Verschlüsselt")
True gibt an, dass die Datei verschlüsselt ist.
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
Encryptionmethod
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Verschlüsselungsmethode")
Freiformzeichenfolge, die den Algorithmus oder das Tool zum Verschlüsseln einer logischen Datei identifiziert. Wenn das Verschlüsselungsschema nicht geschützt ist (z. B. aus Sicherheitsgründen), verwenden Sie "Unknown". Wenn die Datei verschlüsselt ist, aber entweder ihr Verschlüsselungsschema unbekannt ist oder nicht offengelegt wird, verwenden Sie "Encrypted". Wenn die logische Datei nicht verschlüsselt ist, verwenden Sie "Not Encrypted".
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
Erweiterung
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Behoben:, Schema ("Win32"), DisplayName ("Dateierweiterung")
Dateinamenerweiterung ohne den vorherigen Punkt (Punkt).
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
Beispiel: "txt", "mof", "mdb"
FileName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Behoben:, Schema ("Win32"), DisplayName ("Dateiname")
Dateiname ohne Dateierweiterung.
Diese Eigenschaft wird von CIM _ LogicalFile geerbt.
Beispiel: "MyDataFile"
FileSize
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Size"), Units ("bytes")
Größe der Datei in Bytes.
Diese Eigenschaft wird von CIM _ LogicalFile geerbt.
Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.
FileType
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32"), DisplayName ("Dateityp")
Deskriptor, der den Dateityp darstellt (angegeben durch die Extension-Eigenschaft).
Diese Eigenschaft wird von CIM _ LogicalFile geerbt.
FSCreationClassName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Propagated ("CIM _ FileSystem.CreationClassName"), CIM _ Key, DisplayName ("File System Class Name")
Klasse des Dateisystems.
Diese Eigenschaft wird von CIM _ LogicalFile geerbt.
FSName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Propagated ("CIM _ FileSystem.Name"), _ CIM-Schlüssel, DisplayName ("Dateisystemname")
Name des Dateisystems.
Diese Eigenschaft wird von CIM _ LogicalFile geerbt.
Hidden
-
Datentyp: boolescher Wert
-
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 ("Installation date")
Datum und Uhrzeit der Installation des Objekts. Diese Eigenschaft benötigt keinen Wert, um anzugeben, dass das Objekt installiert ist.
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
InUseCount
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Aktuelle Anzahl geöffneter Dateien")
Anzahl der "Datei wird geöffnet", die derzeit für die Datei aktiv sind.
Diese Eigenschaft wird von CIM _ LogicalFile geerbt.
Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.
LastAccessed
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Letzter Zugriff")
Datum und Uhrzeit des letzten Datei-Zugriffes.
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.
Name
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schlüssel
Geerbter Name, der als Schlüssel einer logischen Dateiinstanz innerhalb eines Dateisystems dient (geben Sie vollständige Pfadnamen an).
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
Beispiel: "C: \ Windows \ System \win.ini"
Path
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Behoben:, Schema ("Win32"), DisplayName ("Path")
Pfad der Datei, einschließlich vor- und nachher folgende schräge Schrägstriche. Diese Eigenschaft wird von CIM _ LogicalFile geerbt.
Beispiel: " \ windows \ system \ "
Lesbar
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Readable")
True gibt an, dass die Datei gelesen werden kann.
Diese Eigenschaft wird von CIM _ LogicalFile geerbt.
Status
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10), DisplayName ("Status")
Eine Zeichenfolge, die den aktuellen Status des Objekts angibt. Betriebsstatus und nicht betriebsbereiter Status können definiert werden. Der Betriebsstatus kann "OK", "Heruntergestuft" und "Fehler vor dem Ausfall" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. eine SMART-fähige Festplatte).
Der nicht operative Status kann "Error", "Starting", "Stopping" und "Service" enthalten. "Dienst" kann während der Spiegelung des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben angewendet werden. Nicht alle diese 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")
Heruntergestuft ("Heruntergestuft")
Unbekannt ("Unbekannt")
Pred Fail ("Pred Fail")
Wird gestartet ("Wird gestartet")
Wird beendet ("Wird beendet")
Dienst ("Dienst")
Mannslast ("1000")
NonRecover ("NonRecover")
Kein Kontakt ("Kein Kontakt")
Verlorenes Komma ("Verlorenes Komma")
System
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32"), DisplayName ("Systemdatei")
True gibt an, dass die Datei eine Systemdatei ist.
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
Schreibbar
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Schreibbar")
True gibt an, dass die Datei geschrieben werden kann.
Diese Eigenschaft wird von CIM _ LogicalFilegeerbt.
Hinweise
Die CIM _ DeviceFile-Klasse wird von CIM _ LogicalFileabgeleitet.
WMI implementiert diese Klasse nicht.
Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die von dmtf veröffentlicht wurden. Möglicherweise hat Microsoft Änderungen vorgenommen, um kleinere Fehler zu korrigieren, den Dokumentationsstandards des Microsoft SDK zu entsprechen oder weitere Informationen bereitzustellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| MOF |
|
| DLL |
|