CIM_DataFile

Here are some basic code samples to get you started:

• Getting all instances using PowerShell:
  

  # getting all instances: Get-WMIObject -Class CIM_DataFile # viewing default property in GridView: Get-WMIObject -Class CIM_DataFile |    Out-GridView # using CIM cmdlet  # requires PowerShell 3.0 or better: Get-CIMInstance -ClassName CIM_DataFile

• Selecting all properties (view full object content):
  

  # viewing all properties: Get-WMIObject -Class CIM_DataFile |    Select-Object -Property * # Note: replace "*" with a comma-separated lists of properties to show only selected properties. # displaying information in GridView: # (Note: Out-GridView can only display a maximum of 30 columns. Additional properties are not shown.) Get-WMIObject -Class CIM_DataFile |    Select-Object -Property * |    Out-GridView -Title "CIM_DataFile"

• Querying information remotely:
  

  # connecting to a remote machine using current identity: $ComputerName = 'SomeServerNameOrIP' Get-WMIObject -Class CIM_DataFile -ComputerName $ComputerName # using credentials: $ComputerName = 'SomeServerNameOrIP' $Username = 'mydomain\\myusername' Get-WMIObject -Class CIM_DataFile -ComputerName $ComputerName -Credential $Username

In this WMI class, all WMI properties are read-only. You can only read values but not change them.

AccessMask

Data type UInt32

The AccessMask property is a bit array representing the access rights to the given file or directory held by the user or group on whose behalf the instance is returned. This property is only supported under Windows NT and Windows 2000. On Windows 98 and on Windows NT/2000 FAT volumes, FULL_ACCESS is returned, indicating no security has been set on the object.

Archive

Data type Boolean

The Archive property is a boolean value indicating that the file should be archived.

Caption

Data type String

The Caption property is a short textual description (one-line string) of the object.

Compressed

Data type Boolean

The Compressed property is a boolean value indicating that the file is compressed.

CompressionMethod

Data type String

The CompressionMethod property is a free form string indicating the algorithm or tool used to compress the logical file. If it is not possible (or not desired) to describe the compression scheme (perhaps because it is not known), use the following words: “Unknown” to represent that it is not known whether the logical file is compressed or not, “Compressed” to represent that the file is compressed but either its compression scheme is not known or not disclosed, and “Not Compressed” to represent that the logical file is not compressed.

CreationClassName

Data type String

The CreationClassName property is a string indicating the name of this class.

CreationDate

Data type DateTime

The CreationDate property is a datetime value indicating the file’s creation date.

CSCreationClassName

Data type String

The CSCreationClassName property is a string indicating the class of the computer system.

CSName

Data type String

The CSName property is a string indicating the name of the computer system.

Description

Data type String

The Description property provides a textual description of the object.

Drive

Data type String

The Drive property is a string representing the drive letter (including colon) of the file. Example: c:

EightDotThreeFileName

Data type String

The EightDotThreeFileName property is a string representing the DOS-compatible file name for this file.

Example: c:\progra~1

Encrypted

Data type Boolean

The Encrypted property is a boolean value indicating that the file is encrypted.

EncryptionMethod

Data type String

The EncryptionMethod property is a free form string indicating the algorithm or tool used to encrypt the logical file. If it is not possible (or not desired) to describe the encryption scheme (perhaps for security reasons), use the following words: “Unknown” to represent that it is not known whether the logical file is encrypted or not, “Encrypted” to represent that the file is encrypted but either its encryption scheme is not known or not disclosed, and “Not Encrypted” to represent that the logical file is not encrypted.

Extension

Data type String

The Extension property is a string representing the file’s extension (without the dot). Example: txt, mof, mdb.

FileName

Data type String

The FileName property is a string representing the filename (without extension) of the file. Example: autoexec

FileSize

Data type UInt64

The FileSize property represents the size of the file (in bytes).

FileType

Data type String

The FileType property is a string descriptor representing the file type (indicated by the Extension property).

FSCreationClassName

Data type String

The FSCreationClassName property is a string indicating the class of the file system.

FSName

Data type String

The FSName property is string indicating the name of the file system.

Hidden

Data type Boolean

The Hidden property is a boolean value indicating if the file is hidden.

InstallDate

Data type DateTime

The InstallDate property is datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.

InUseCount

Data type UInt64

The InUseCount property is an integer indicating the number of ‘file opens’ that are currently active against the file.

LastAccessed

Data type DateTime

The LastAccessed property is a datetime value indicating the time the file was last accessed.

LastModified

Data type DateTime

The LastModified property is a datetime value indicating the time the file was last modified.

Manufacturer

Data type String

Manufacturer string from version resource if one is present.

Name

Data type String

The Name property is a string representing the inherited name that serves as a key of a logical file instance within a file system. Full path names should be provided. Example: c:\winnt\system\win.ini

Path

Data type String

The Path property is a string representing the path of the file. This includes leading and trailing backslashes. Example: \windows\system\

Readable

Data type Boolean

The Readable property is a boolean value indicating if the file can be read.

Status

Data type String

The Status property is a string indicating the current status of the object. Various operational and non-operational statuses can be defined. Operational statuses are “OK”, “Degraded” and “Pred Fail”. “Pred Fail” indicates that an element may be functioning properly but predicting a failure in the near future. An example is a SMART-enabled hard drive. Non-operational statuses can also be specified. These are “Error”, “Starting”, “Stopping” and “Service”. The latter, “Service”, could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is on-line, yet the managed element is neither “OK” nor in one of the other states.

System

Data type Boolean

The system property is a boolean value indicating if the file is a system file.

Version

Data type String

Version string from version resource if one is present.

Writeable

Data type Boolean

The Writeable property is a boolean value indicating if the file can be written.

ChangeSecurityPermissions

The ChangeSecurityPermissions method changes the security permissions for the logical file specified in the object path. If the logical file is actually a directory, then ChangeSecurityPermissions will act recursively, changing the security permissions of all the files and sub-directories the directory contains. ChangeSecurityPermissions returns an integer value of 0 if the permissions were changed, and any other number to indicate an error.

It returns one of the following integer values:

View full documentation.

ChangeSecurityPermissionsEx

The ChangeSecurityPermissionsEx method changes the security permissions for the logical file specified in the object path. If the logical file is actually a directory, then this method will act recursively, changing the security permissions of all the files and sub-directories the directory contains. ChangeSecurityPermissionsEx returns an integer value of 0 if the permissions were changed, and any other number to indicate an error. The ChangeSecurityPermissionsEx method is an extended version of the ChangeSecurityPermissions method.

It returns one of the following integer values:

View full documentation.

Compress

The Compress method compresses the logical file (or directory) specified in the object path. Compress returns an integer value of 0 if the file was successfully compressed, and any other number to indicate an error.

It returns one of the following integer values:

View full documentation.

CompressEx

The CompressEx method compresses the logical file (or directory) specified in the object path. CompressEx returns an integer value of 0 if the file was successfully compressed, and any other number to indicate an error. CompressEx is an extended version of the Compress method.

It returns one of the following integer values:

View full documentation.

Copy

The Copy method copies the logical file or directory specified in the object path to the location specified by the input parameter. Copy returns an integer value of 0 if the file was successfully copied, and any other number to indicate an error. A copy is not supported if overwriting an existing logical file is required.

It returns one of the following integer values:

View full documentation.

CopyEx

The CopyEx method copies the logical file or directory specified in the object path to the location specified by the FileName parameter. CopyEx returns an integer value of 0 if the file was successfully copied, and any other number to indicate an error. A copy is not supported if overwriting an existing logical file is required. CopyEx is an extended version of the Copy method.

It returns one of the following integer values:

View full documentation.

Delete

The Delete method will delete the logical file (or directory) specified in the object path. Delete returns an integer value of 0 if the file was successfully deleted, and any other number to indicate an error.

It returns one of the following integer values:

View full documentation.

DeleteEx

The DeleteEx method will delete the logical file (or directory) specified in the object path. DeleteEx returns an integer value of 0 if the file was successfully deleted, and any other number to indicate an error. DeleteEx is an extended version of the Delete method.

It returns one of the following integer values:

View full documentation.

GetEffectivePermission

The GetEffectivePermission method determines whether the caller has the aggregated permissions specified by the Permission argument not only on the file object, but on the share the file or directory resides on (if it is on a share).

View full documentation.

Rename

The Rename method renames the logical file (or directory) specified in the object path. Rename returns an integer value of 0 if the file was successfully renamed, and any other number to indicate an error. A rename is not supported if the destination is on another drive or overwriting an existing logical file is required

It returns one of the following integer values:

View full documentation.

TakeOwnerShip

The TakeOwnerShip method obtains ownership of the logical file specified in the object path . If the logical file is actually a directory, then TakeOwnerShip will act recursively, taking ownership of all the files and sub-directories the directory contains.

It returns one of the following integer values:

View full documentation.

TakeOwnerShipEx

The TakeOwnerShipEx method obtains ownership of the logical file specified in the object path. If the logical file is actually a directory, then this method will act recursively, taking ownership of all the files and sub-directories the directory contains. TakeOwnerShipEx returns an integer value of 0 on success, and any other number to indicate an error. TakeOwnerShipEx is an extended version of the TakeOwnerShip method.

It returns one of the following integer values:

View full documentation.

Uncompress

The Uncompress method uncompresses the logical file (or directory) specified in the object path. Uncompress returns an integer value of 0 if the file was successfully decompressed, and any other number to indicate an error.

It returns one of the following integer values:

View full documentation.

UncompressEx

The UncompressEx method uncompresses the logical file (or directory) specified in the object path. UncompressEx returns an integer value of 0 if the file was successfully decompressed, and any other number to indicate an error. UncompressEx is an extended version of the Uncompress method.

It returns one of the following integer values:

View full documentation.

 Click here to search for examples in the Internet.

CIM_Directory

Directory is a type of file that logically groups data files ‘contained’ in it, and provides path information for the grouped files.

CIM_LogicalDevice

An abstraction or emulation of a hardware entity, that may or may not be realized in physical hardware.

CIM_Process

Each instance of the CIM_Process class represents a single instance of a running program.

Win32_DCOMApplication

The Win32_DCOMApplication class represents the properties of a DCOM application.

Win32_LogicalProgramGroupItem

The Win32_LogicalProgramGroupItem class represents an element contained by a Win32_ProgramGroup, that is not itself another Win32_ProgramGroup.

Win32_PnPSignedDriver

The Win32_PnPSignedDriver class provides digital signature information about drivers.

Win32_Printer

Capabilities and management of the Printer LogicalDevice.

You have a question about WMI in general or this particular WMI Class? Then please visit our free forum: Help me with WMI. There are even more forums to assist you, so you may want to look at the full forum list to pick the best one.

Please use the comment form below to actively submit new content for this page. So if you found an error or have sample code showing this class in action, please share by using the comment form on the bottom of this page.