CIM_DeviceFile-Klasse
Die CIM_DeviceFile-Klasse stellt einen Typ der logischen Datei dar, der ein Gerät darstellt. Diese Konvention ist nützlich für Betriebssysteme, die Geräte mit einem Bytestream-E/A-Modell verwalten. Das logische Gerät, das dieser Datei zugeordnet ist, wird mithilfe der CIM_DeviceAccessedByFile Beziehung angegeben.
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
[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 folgende Membertypen:
Methoden
Die CIM_DeviceFile-Klasse verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| ChangeSecurityPermissions | Ändert die Sicherheitsberechtigungen für die im Objektpfad angegebene logische Datei. Nicht von WMI implementiert. |
| ChangeSecurityPermissionsEx | Ändert die Sicherheitsberechtigungen für die im Objektpfad angegebene logische Datei. 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 im Objektpfad angegebene logische Datei (oder das Verzeichnis) an den durch den Eingabeparameter angegebenen Speicherort. Nicht von WMI implementiert. |
| CopyEx | Kopiert die im Objektpfad angegebene logische Datei (oder das Verzeichnis) an den durch den 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 im Objektpfad angegebene logische Datei (oder das Verzeichnis) um. Nicht von WMI implementiert. |
| TakeOwnerShip | Ruft den Besitz der logischen Datei ab, die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| TakeOwnerShipEx | Ruft den Besitz der logischen Datei ab, die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| Dekomprimieren | Entpackt die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert. |
| UncompressEx | Entpackt 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 angegebene Datei oder das angegebene Verzeichnis darstellt, die von dem Benutzer oder der Gruppe verwaltet wird, in deren Namen die instance zurückgegeben wird. Auf FAT-Volumes wird 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)
-
Gewährt das Recht, Daten aus der Datei zu lesen. Für ein 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 anzufü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 (Datei) 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 darin enthaltenen Dateien (seine untergeordneten Elemente) zu löschen, auch wenn die Dateien schreibgeschützt sind.
-
FILE_READ_ATTRIBUTES (128)
-
Gewährt das Recht zum Lesen von Dateiattributen.
-
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 den Besitzer.
-
WRITE_DAC (262144)
-
Gewährt Schreibzugriff auf die ermessensbezogene ACL.
-
WRITE_OWNER (524288)
-
Weist den Schreibbesitzer zu.
-
SYNCHRONIZE (1048576)
-
Synchronisiert den Zugriff und ermöglicht es einem Prozess, darauf zu warten, dass ein Objekt in den signalierten Zustand wechselt.
Archivieren
-
Datentyp: boolean
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32"), DisplayName ("Sollte archiviert werden")
True gibt an, dass die Datei archiviert werden soll.
Diese Eigenschaft wird von CIM_LogicalFile geerbt.
Caption
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64), DisplayName ("Caption")
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")
Erstellungsdatum 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")
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. Diese Eigenschaft wird von CIM_LogicalFile geerbt.
Beispiel: "c:"
EightDotThreeFileName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32"), DisplayName ("Eight Dot Three File Name")
DOS-kompatibler Dateiname für die Datei. Diese Eigenschaft wird von CIM_LogicalFile geerbt.
Beispiel: "c:\progra~1"
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).
Diese Eigenschaft wird von CIM_LogicalFile geerbt.
Beispiel: "txt", "mof", "mdb"
FileName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Behoben, Schema ("Win32"), DisplayName ("Dateiname")
Dateiname ohne Dateinamenerweiterung.
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 (durch die Extension-Eigenschaft angegeben).
Diese Eigenschaft wird von CIM_LogicalFile geerbt.
FSCreationClassName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Weitergegeben ("CIM_FileSystem. CreationClassName"), CIM_Key, DisplayName ("Dateisystemklassenname")
Klasse des Dateisystems.
Diese Eigenschaft wird von CIM_LogicalFile geerbt.
FSName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Weitergegeben ("CIM_FileSystem. Name"), CIM_Key, DisplayName ("Dateisystemname")
Name des Dateisystems.
Diese Eigenschaft wird von CIM_LogicalFile geerbt.
Hidden
-
Datentyp: Boolesch
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32"), DisplayName ("Hidden")
Bei True ist die Datei ausgeblendet.
Diese Eigenschaft wird von CIM_LogicalFile geerbt.
InstallDate
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")
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 ("Current File Open Count")
Anzahl der "Datei ö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 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.
Name
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schlüssel
Geerbter Name, der als Schlüssel einer logischen Datei instance innerhalb eines Dateisystems dient (vollständige Pfadnamen bereitstellen).
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
Beispiel: "C:\Windows\system\win.ini"
Pfad
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Behoben, Schema ("Win32"), DisplayName ("Pfad")
Pfad der Datei, einschließlich führender und nachgestellter umgekehrter Schrägstriche. Diese Eigenschaft wird von CIM_LogicalFile geerbt.
Beispiel: "\windows\system\"
Lesbar
-
Datentyp: Boolesch
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("lesbar")
Wenn True, kann die Datei gelesen werden.
Diese Eigenschaft wird von CIM_LogicalFile geerbt.
Status
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10), DisplayName ("Status")
Zeichenfolge, die den aktuellen status des Objekts angibt. Es können operative und nicht operative status 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. ein SMART-fähiges Festplattenlaufwerk).
Nicht-operationale status können "Error", "Starting", "Stop" und "Service" enthalten. "Dienst" kann beim Spiegel des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten 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")
Starten ("Start")
Beenden ("Beenden")
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.
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_DeviceFile-Klasse wird von CIM_LogicalFile abgeleitet.
WMI implementiert diese Klasse nicht.
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.
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