Get-DfsrConnection

Get-DfsrConnection

Gets a connection between DFS Replication partners.

Syntax

Parameter Set: Default
Get-DfsrConnection [[-GroupName] <String[]> ] [[-SourceComputerName] <String> ] [[-DestinationComputerName] <String> ] [[-DomainName] <String> ] [ <CommonParameters>]

Detailed Description

The Get-DfsrConnection cmdlet gets an existing connection between two DFS Replication partners.

DFS Replication connections are the logical partnerships between members in a replication group. The DFS Replication service uses the Remote Procedure Call (RPC) protocol to communicate between servers.

Parameters

-DestinationComputerName<String>

Specifies the name of the receiving computer. A receiving computer is also called an inbound or downstream computer.

Aliases

ReceivingMember,RMem

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DomainName<String>

Specifies the NetBIOS name or fully qualified domain name (FQDN) for the Active Directory Domain Service (AD DS) domain that contains the replication group. If you do not specify this parameter, the cmdlet uses the domain of the current user.

Aliases

none

Required?

false

Position?

101

Default Value

[Current Domain]

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-GroupName<String[]>

Specifies an array of names of replication groups. You can use a comma separated list and the wildcard character (*).

Aliases

RG,RgName

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

true

-SourceComputerName<String>

Specifies the name of the sending computer. A sending computer is also called an outbound or upstream computer.

Aliases

SendingMember,SMem

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • Microsoft.DistributedFileSystemReplication.DfsReplicationGroup

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.DistributedFileSystemReplication.DfsrConnection

Examples

Example 1: Get a one-way connection between computers

This command gets the one-way connection from the computer named SRV01 to the computer named SRV02 in the RG24 replication group.

PS C:\> Get-DfsrConnection -GroupName "RG24" -SourceComputerName "SRV01" -DestinationComputerName "SRV02"

Add-DfsrConnection

Set-DfsrConnection

Remove-DfsrConnection