Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |
|