DfsrVolumeConfig class

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

Syntax

[Dynamic, Provider("DfsrConfigProv")]
class DfsrVolumeConfig : CIM_Setting
{
  string   Caption;
  string   Description;
  string   SettingID;
  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 DfsrVolumeConfig class has these types of members:

Methods

The DfsrVolumeConfig class has these methods.

MethodDescription
ResumeReplication

Resumes replication for the volume.

Windows Server 2012, Windows Server 2008 R2, Windows Server 2008, and Windows Vista:  This method is not supported until Windows Server 2012 R2.

 

Properties

The DfsrVolumeConfig class has these properties.

Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64)

Short textual description of the CIM_Setting object.

This property is inherited from CIM_Setting.

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.

Windows Vista and Windows Server 2008:  This property is not supported until Windows Server 2008 R2.

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

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

Description
Data type: string
Access type: Read-only

Textual description of the CIM_Setting object.

This property is inherited from CIM_Setting.

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, or FALSE if it is a local volume.

Windows Vista and Windows Server 2008:  This property is not supported until Windows Server 2008 R2.

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

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. This is the name of the DC 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: DisplayName ("Maximum number of Jet Sessions"), MinValue (16)

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.

Windows Vista and Windows Server 2008:  This property is not supported until Windows Server 2008 R2.

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

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 will 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.

SettingID
Data type: string
Access type: Read-only
Qualifiers: MaxLen (256)

Identifier by which the CIM_Setting object is known.

This property is inherited from CIM_Setting.

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

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

Windows Vista and Windows Server 2008:  This property is not supported until Windows Server 2008 R2.

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

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

Windows Vista

Minimum supported server

Windows Server 2008

End of client support

Windows Vista

Namespace

Root\MicrosoftDfs

MOF

DfsRProvs.mof

DLL

DfsRWmiV2.dll

See also

CIM_Setting
DFSR WMI Classes

 

 

Show: