DfsrReplicationGroupConfig class

An instance of this class is available for each replication group that contains this computer. This class provides read-only access to the replication group configuration parameters.

Syntax

[Dynamic, Provider("DfsrConfigProv")]
class DfsrReplicationGroupConfig : CIM_Setting
{
  string   Caption;
  string   SettingID;
  string   ReplicationGroupGuid;
  string   ReplicationGroupName;
  string   ReplicationGroupDn;
  uint32   ReplicationGroupType;
  uint32   LastChangeNumber;
  datetime LastChangeTime;
  string   LastChangeSource;
  uint32   TombstoneExpiryInMin;
  string   Description;
  Boolean  DefaultScheduleInUtc;
  uint8    DefaultSchedule[];
  string   ContainerComputerName;
  boolean  IsClustered;
  string   VcoResourceName;
};

Members

The DfsrReplicationGroupConfig class has these types of members:

Properties

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

ContainerComputerName

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Replication group AD computer name")

The name of the Active Directory computer object that holds the replication group information. Normally this name is same as the NETBIOS name of the local computer.

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

DefaultSchedule

Data type: uint8 array

Access type: Read-only

Qualifiers: DisplayName ("Default Schedule")

The default replication schedule to be used for any connection in this connection object that does not have a defined schedule.

The data is a series of 336 bytes: 2 bytes for each of the 24 hours per day, 7 days per week. The 2 bytes for each hour are divided into 4 groups of 4 bits. Each 4-bit group can be assigned one of the following values.

BANDWIDTH_LEVEL_OFF (0x0)

No replication.

BANDWIDTH_LEVEL_16_KBPS (0x1)

16 kilobits per second (Kbps).

BANDWIDTH_LEVEL_64_KBPS (0x2)

64 Kbps.

BANDWIDTH_LEVEL_128_KBPS (0x3)

128 Kbps.

BANDWIDTH_LEVEL_256_KBPS (0x4)

256 Kbps.

BANDWIDTH_LEVEL_512_KBPS (0x5)

512 Kbps.

BANDWIDTH_LEVEL_1_MBPS (0x6)

1 Mbps.

BANDWIDTH_LEVEL_2_MBPS (0x7)

2 Mbps.

BANDWIDTH_LEVEL_4_MBPS (0x8)

4 Mbps.

BANDWIDTH_LEVEL_8_MBPS (0x9)

8 Mbps.

BANDWIDTH_LEVEL_16_MBPS (0xA)

16 Mbps.

BANDWIDTH_LEVEL_32_MBPS (0xB)

32 Mbps.

BANDWIDTH_LEVEL_64_MBPS (0xC)

64 Mbps.

BANDWIDTH_LEVEL_128_MBPS (0xD)

128 Mbps.

BANDWIDTH_LEVEL_256_MBPS (0xE)

256 Mbps.

BANDWIDTH_LEVEL_INFINITE (0xF)

Full bandwidth (no throttling.)

DefaultScheduleInUtc

Data type: Boolean

Access type: Read-only

Qualifiers: DisplayName ("Default Schedule in UTC")

Indicates whether the schedule is to be interpreted as UTC (default) or local time.

Description

Data type: string

Access type: Read-only

The user-specified description of the content or purpose of the current replication group.

IsClustered

Data type: boolean

Access type: Read-only

Qualifiers: DisplayName ("Is AD computer represent a VCO")

Set to TRUE if the Active Directory server that holds the replicated folder is a virtual computer in a cluster, or FALSE if it is a local computer.

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 replication group 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 Active Directory server.

LastChangeTime

Data type: datetime

Access type: Read-only

Qualifiers: DisplayName ("Last Change Time")

The time stamp of the last configuration change.

ReplicationGroupDn

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Replication Group Distinguished Name")

The distinguished name of the corresponding ms-DFSR-ReplicationGroup object in the Active Directory.

ReplicationGroupGuid

Data type: string

Access type: Read-only

Qualifiers: Key, DisplayName ("Replication Group GUID"), MaxLen (36), MinLen (36)

The unique identifier of the replication group.

ReplicationGroupName

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Replication Group Name")

The friendly name of the replication group. This name is not required to be unique.

ReplicationGroupType

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Replication Group Type")

The type of the replication group.

OTHER (0)

SYSVOL (1)

PROTECTION (2)

DISTRIBUTION (3)

CLIENT (4)

PEERNET (5)

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.

TombstoneExpiryInMin

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Tombstone Expiration In Minutes"), MinValue (60)

The maximum lifetime of tombstone objects, in minutes.

VcoResourceName

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Content Set VCO Resource Name")

If the replication group is configured against a virtual computer, this property specifies the Network Name resource of the clustered replication group.

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

Examples

The Get-DFSRBacklog PowerShell code sample on TechNet Gallery uses DfsrReplicationGroupConfig to retrieve DFSR backlog for replication groups of the targeted server.

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