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 |
|
| DLL |
|