MSFT_DfsrVolumeConfig class

Article
05/31/2018

This class stores the per-volume settings for each volume on the system that hosts one or more replicated folders.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

[ClassVersion("1.0.0"), dynamic, provider("DfsrWMIV2"), AMENDMENT]
class MSFT_DfsrVolumeConfig
{
  string   VolumeGuid;
  uint64   SerialNumber;
  string   VolumePath;
  uint32   LastChangeNumber;
  datetime LastChangeTime;
  string   LastChangeSource;
  string   DatabasePath;
  uint32   MinNtfsJournalSizeInMb;
  uint32   UsnCheckPoint;
  uint32   MaxJetSessions;
  boolean  IsClustered;
  string   ClusterDiskResName;
};

Members

The MSFT_DfsrVolumeConfig class has these types of members:

Methods
Properties

Methods

The MSFT_DfsrVolumeConfig class has these methods.

Method	Description
ExportDBClone	Starts the process of exporting the Distributed File System Replication (DFSR) database for the specified volume.
GetDBCloneState	Returns the current state of the database export or import process.
ImportDBClone	Starts the process of importing the specified Distributed File System Replication (DFSR) volume database.
ResetDBClone	Stops the current database export or import operation and returns the database to its previous state.
ResumeReplication	Resumes replication for the volume.

Properties

The MSFT_DfsrVolumeConfig class has these properties.

ClusterDiskResName

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Clustered Volume Physical Disk Resource Name")

If the volume is a cluster shared volume, this property specifies the physical disk resource name.

DatabasePath

Data type: string
Access type: Read-only
Qualifiers: MaxLen (2600), DisplayName ("Database Path")

The full path to the database. This database contains metadata about the files and folders in the replicated folder.

IsClustered

Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("Is a clustered Volume")

This property is TRUE if the volume is a cluster shared volume; it is FALSE if it is a local volume.

LastChangeNumber

Data type: uint32
Access type: Read-only
Qualifiers: MinValue ("1"), DisplayName ("Last Change Number")

The configuration sequence number. This value is incremented each time the volume configuration changes.

LastChangeSource

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Last Change Source")

Information about the originator of the last configuration change. The originator is the name of the domain controller that provided the configuration information.

LastChangeTime

Data type: datetime
Access type: Read-only
Qualifiers: DisplayName ("Last Change Time")

The time stamp of the last configuration change.

MaxJetSessions

Data type: uint32
Access type: Read-only
Qualifiers: MinValue ("16"), DisplayName ("Maximum number of Jet Sessions")

The maximum number of concurrent Jet database sessions for this volume. Every volume has its own database, and therefore this parameter is defined per-volume.

MinNtfsJournalSizeInMb

Data type: uint32
Access type: Read/write
Qualifiers: MinValue ("4"), MaxValue ("10000"), Units ("MB"), DisplayName ("Minimum USN Journal Size in MB")

The minimum size of the journal to allocate on the volume, in megabytes. If no journal exists, the DFSR creates a new journal with the specified size; otherwise, it increases the existing journal size to this minimum size. The DFSR does not change the existing journal size if it is already larger than the new minimum size.

SerialNumber

Data type: uint64
Access type: Read-only
Qualifiers: DisplayName ("Volume Serial Number")

The volume serial number.

UsnCheckPoint

Data type: uint32
Access type: Read-only
Qualifiers: MinValue ("1"), DisplayName ("Usn Check Point")

The number of journal updates to accumulate before committing a transaction.

VolumeGuid

Data type: string
Access type: Read-only
Qualifiers: key, MaxLen (36), MinLen (36), DisplayName ("Volume GUID")

The unique volume identifier.

VolumePath

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Volume Path")

The volume path name.

This string has one of the following formats: "\\.\drive:" or "\\?\volume{GUID}".

Requirements


Minimum supported client	None supported
Minimum supported server	Windows Server 2012 R2
Namespace	Root\Microsoft\Windows\Dfsr
MOF	Dfsrwmiv2.mof
DLL	DfsRWmiV2.dll