Compartir a través de


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