DfsrConnectionConfig

DfsrConnectionConfig class

This class provides the configuration settings for a replication group connection. Each connection links a local and remote member, establishing a partnership. Only the connections of the direct partners to the local member have instances of this class.

Syntax

[Dynamic, Provider("DfsrConfigProv")]
class DfsrConnectionConfig : CIM_Setting
{
  string  Caption;
  string  Description;
  string  SettingID;
  string  ConnectionGuid;
  string  ConnectionDn;
  string  MemberGuid;
  string  PartnerGuid;
  string  PartnerName;
  string  PartnerDn;
  string  PartnerDns;
  string  ReplicationGroupGuid;
  boolean Inbound;
  boolean Enabled;
  string  Keywords;
  boolean RdcEnabled;
  uint32  RdcMinFileSizeInKb;
  Boolean ScheduleInUtc;
  uint8   Schedule[];
};

Members

The DfsrConnectionConfig class has these types of members:

Properties

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

ConnectionDn
Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Connection Distinguished Name")

The distinguished name of the corresponding DFSR2-Connection object in the Active Directory Domain Services.

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

The unique connection identifier.

Description
Data type: string
Access type: Read-only

Textual description of the CIM_Setting object.

This property is inherited from CIM_Setting.

Enabled
Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("Enabled Connection")

Indicates whether the connection is disabled. If the connection is enabled, then DFSR will use it; otherwise, it is ignored.

Inbound
Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("Incoming Connection")

Indicates the direction of the connection between the local member and the partner; it can be inbound (from partner to member) or outbound (member to partner).

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

User-defined strings that are used by monitoring and configuration tools and for grouping or identification purposes.

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

The identifier of the local member in this connection.

PartnerDn
Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Partner Distinguished Name")

The distinguished name of the corresponding DFSR2-Member object in the Active Directory Domain Services that represents the partner.

PartnerDns
Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Partner DNS")

The partner-qualified DNS name.

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

The identifier of the partner object in this connection.

PartnerName
Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Partner Name")

The partner name. This is typically the unqualified DNS name of the partner computer.

RdcEnabled
Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("RDC Enabled")

Indicates whether RDC is enabled on this connection.

RdcMinFileSizeInKb
Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("RDC Minimum File Size in KB")

The RDC minimum file size, in kilobytes. RDC is applied only on files that are this size or larger.

ReplicationGroupGuid
Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Replication Group GUID"), MaxLen (36), MinLen (36)

The unique replication group identifier.

Schedule
Data type: uint8 array
Access type: Read-only
Qualifiers: DisplayName ("Schedule")

The replication schedule for this connection.

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

ScheduleInUtc
Data type: Boolean
Access type: Read-only
Qualifiers: DisplayName ("Schedule in UTC")

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

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.

Examples

The Get-DFSRBacklog PowerShell code sample on TechNet Gallery uses DfsrConnectionConfig 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

 

 

Show:
© 2016 Microsoft