Fsutil: objectid

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Fsutil: objectid

Typically used by support professionals. Manages object identifiers (also known as OIDs), which are internal objects used by the Distributed Link Tracking (DLT) Client service and File Replication service (FRS) to track other objects such as files, directories, and links. Object identifiers are invisible to most programs and should never be modified.

Warning

  • Do not delete, set, or otherwise modify an object identifier. Deleting or setting an object identifier can result in the loss of data from portions of a file, up to and including entire volumes of data. In addition you might cause adverse behavior in the Distributed Link Tracking (DLT) Client service and File Replication service (FRS).
Syntax

fsutil objectid [create] FileName

fsutil objectid [delete] FileName

fsutil objectid [query] FileName

fsutil objectid [set] ObjectID BirthVolumeID BirthObjectID DomainID FileName

Parameters
  • create
    Creates object identifier if the file does not already have one, otherwise equivalent to query.
  • delete
    Deletes an object identifier.
  • query
    Queries an object identifier.
  • set
    Sets an object identifier.
  • ObjectID
    A file-specific 16 byte hexadecimal identifier that is guaranteed to be unique within a volume. It is used by the Distributed Link Tracking (DLT) Client service and the File Replication service (FRS) to identify files. Any file that has an ObjectID, also has a BirthVolumeID, a BirthObjectID, and a DomainID. When you move a file, the ObjectID may change, but BirthVolumeID and BirthObjectID remain the same, which enables Windows XP and the Windows Server 2003 family of operating systems to always find a file, no matter where it has been moved.
  • BirthVolumeID
    A 16 byte hexadecimal identifier that indicates the volume on which the file was located when it first obtained an ObjectID. This value is used by the DLT Client service.
  • BirthObjectID
    A 16 byte hexadecimal identifier that indicates the file's original ObjectID (note that the ObjectID may change when a file is moved). This value is used by the DLT Client service.
  • DomainID
    16 byte hexadecimal domain identifier. This value is not currently used and must be set to all zeros.
  • FileName
    Specifies the full path to the file including the file name and extension, for example C:\documents\filename.txt.
Examples

To create an object identifier, type:

fsutil objectid create C:\Temp\sample.txt

To delete an object identifier, type:

fsutil objectid delete C:\Temp\sample.txt

To query an object identifier, type:

fsutil objectid query C:\Temp\sample.txt

To set an object identifier, type:

fsutil objectid set 40dff02fc9b4d4118f120090273fa9fc f86ad6865fe8d21183910008c709d19e 40dff02fc9b4d4118f120090273fa9fc 00000000000000000000000000000000 C:\Temp\sample.txt

Formatting legend

Format Meaning

Italic

Information that the user must supply

Bold

Elements that the user must type exactly as shown

Ellipsis (...)

Parameter that can be repeated several times in a command line

Between brackets ([])

Optional items

Between braces ({}); choices separated by pipe (|). Example: {even|odd}

Set of choices from which the user must choose only one

Courier font

Code or program output

See Also

Concepts

Fsutil
Command-line reference A-Z
Command shell overview