DfsrMachineConfig class

This class provides service-wide settings on the local computer.

Syntax

[Dynamic, Provider("DfsrConfigProv"), Singleton]
class DfsrMachineConfig : CIM_Setting
{
  string   Caption;
  string   SettingID;
  uint32   LastChangeNumber;
  datetime LastChangeTime;
  string   LastChangeSource;
  string   Description;
  boolean  EnableDebugLog;
  string   DebugLogFilePath;
  uint32   MaxDebugLogFiles;
  uint32   DebugLogSeverity;
  uint32   MaxDebugLogMessages;
  uint32   DsPollingIntervalInMin;
  boolean  EnableLightDSPolling;
  uint32   RpcPortAssignment;
  uint32   ReghostingRateInMin;
  uint32   RootLowWatermarkPercent;
  uint32   RootHighWatermarkPercent;
  uint32   StagingLowWatermarkPercent;
  uint32   StagingHighWatermarkPercent;
  uint32   ConflictLowWatermarkPercent;
  uint32   ConflictHighWatermarkPercent;
  uint32   MaxOfflineTimeInDays;
  boolean  StopReplicationOnAutoRecovery;
};

Members

The DfsrMachineConfig class has these types of members:

• Properties

Properties

The DfsrMachineConfig 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.

ConflictHighWatermarkPercent

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Conflict High Watermark Percentage"), MinValue (80), MaxValue (100)

The conflict cleanup process starts when the size of the Conflict and Deleted folder hits its high watermark. Every replicated folder defines the maximum size of its Conflict and Deleted folder.

ConflictLowWatermarkPercent

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Conflict Low Watermark Percentage"), MinValue (10), MaxValue (80)

The conflict cleanup process stops when the size of the Conflict and Deleted folder hits its low watermark. Every replicated folder defines the maximum size of its Conflict and Deleted folder.

DebugLogFilePath

Data type: string

Access type: Read/write

Qualifiers: DisplayName ("Debug Log File Path"), MaxLen (2600)

The full path of the debug log files.

DebugLogSeverity

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Debug Log Severity"), MinValue (1), MaxValue (5)

The level of detail in the debug log files.

Description

Data type: string

Access type: Read-only

The user-defined description of the current settings.

DsPollingIntervalInMin

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Active Directory Domain Services Polling Interval In Minutes"), MinValue (1)

The number of minutes between the end of one Active Directory Domain Services polling cycle and the start of another.

EnableDebugLog

Data type: boolean

Access type: Read/write

Qualifiers: DisplayName ("Enable Debug Log")

Enables or disables the generation of debug logs.

EnableLightDSPolling

Data type: boolean

Access type: Read/write

Qualifiers: DisplayName ("Enable Light Active Directory Domain Services Polling")

Enables or disables a lightweight check for membership configuration changes in the Active Directory Domain Services. This periodic check speeds up the service response to certain types of configuration changes. If any change are detected, a full poll follows. Lightweight polling does not interfere with the normal polling cycles.

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 computer 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 user who submitted the change.

LastChangeTime

Data type: datetime

Access type: Read-only

Qualifiers: DisplayName ("Last Change Time")

The time stamp of the last configuration change.

MaxDebugLogFiles

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Maximum Debug Log Files"), MinValue (1)

The maximum number of debug log files to be generated. If the number of debug log files exceeds this value, DFSR will delete the oldest debug log file.

MaxDebugLogMessages

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Maximum Debug Log Messages"), MinValue (1000)

The maximum number of log entries in each debug log file.

MaxOfflineTimeInDays

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Max Offline Time In Days"), MinValue (0)

The maximum number of days a replicated folder can be disconnected from other partners before it is put into an error state.

ReghostingRateInMin

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Reghosting Rate In Minutes"), MinValue (60)

Reserved for system use.

RootHighWatermarkPercent

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Root High Watermark Percentage"), MinValue (40)

Reserved for system use.

RootLowWatermarkPercent

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Root Low Watermark Percentage"), MinValue (10)

Reserved for system use.

RpcPortAssignment

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("RPC Port Assignment")

The user-specified RPC port assignment. The default is 0, which indicates any available port. Changes to this value do not take effect until the next time the service starts.

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.

StagingHighWatermarkPercent

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Staging High Watermark Percentage"), MinValue (80), MaxValue (100)

The staging cleanup process starts when the size of the staging folder hits its high watermark. Every replicated folder defines the maximum size of its staging folder.

StagingLowWatermarkPercent

Data type: uint32

Access type: Read/write

Qualifiers: DisplayName ("Staging Low Watermark Percentage"), MinValue (10), MaxValue (80)

The staging cleanup process stops when the size of the staging folder hits its low watermark. Every replicated folder defines the maximum size of its staging folder.

StopReplicationOnAutoRecovery

Data type: boolean

Access type: Read/write

Qualifiers: DisplayName ("Stop Replication on Auto Recovery")

Enables Stop Replication on Auto Recovery feature.

Requirements

Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
End of client support	Windows 7
Namespace	Root\MicrosoftDfs
MOF	DfsRProvs.mof
DLL	DfsRWmiV2.dll

See also

CIM_Setting

DFSR WMI Classes