Get-DfsrBacklog

Windows Server Technical Preview and Windows 10

Applies To: Windows 10, Windows Server Technical Preview

Get-DfsrBacklog

Retrieves the list of pending file updates between two DFS Replication partners.

Syntax

Parameter Set: Default
Get-DfsrBacklog [[-GroupName] <String[]> ] [[-FolderName] <String[]> ] [-SourceComputerName] <String> [-DestinationComputerName] <String> [ <CommonParameters>]




Detailed Description

The Get-DfrsBacklog cmdlet retrieves pending updates between two computers that participate in Distributed File System (DFS) Replication.

Updates can be new, modified, or deleted files and folders. The maximum number of files that this command displays is 100. The Verbose parameter displays a count of all backlogged updates. Any files or folders listed in the DFS Replication backlog have not yet replicated from the source computer to the destination computer. This is not necessarily an indication of problems. A backlog indicates latency, and a backlog may be expected in your environment, depending on configuration, rate of change, network, and other factors.

Parameters

-DestinationComputerName<String>

Specifies the name of the receiving computer. A destination computer is also called an inbound or downstream computer. If you do not specify this parameter, the cmdlet uses the local computer.


Aliases

ReceivingMember,RMem

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-FolderName<String[]>

Specifies an array of names of replicated folders. If you do not specify this parameter, the cmdlet queries for all participating replicated folders. You can specify multiple folders, separated by commas, as well as wildcard characters (*).


Aliases

RF,RfName

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-GroupName<String[]>

Specifies an array of names of replication groups. If you do not specify this parameter, the cmdlet queries for all participating replications 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?

false

-SourceComputerName<String>

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


Aliases

SendingMember,SMem

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see    about_CommonParameters (http://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, Microsoft.DistributedFileSystemReplication.DfsReplicatedFolder, String computerName

Outputs

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

  • Microsoft.DistributedFileSystemReplication.DfsrIdRecord

Examples

Example 1: Retrieve unreplicated changes

This command retrieves the first 100 unreplicated changes between the local computer and the upstream computer SRV02 for the replication group RG01 and the replicated folder RF1A. The command displays all file metadata.


PS C:\> Get-DfsrBacklog -SourceComputerName "SRV02" -GroupName "RG01" -FolderName "RF1A"

Example 2: Retrieve unreplicated changes between upstream and downstream computers

This command retrieves the first 100 unreplicated changes between the downstream computer SRV1 and the upstream computer SRV02 for the replication group RG01 and the replicated folder RF1. The command also formats the output into a table that contains only the file paths and modification dates on the upstream server


PS C:\> Get-DfsrBacklog -DestinationComputerName "SRV1" -SourceComputerName "SRV02" -GroupName "RG01" -FolderName "RF1" | format-table fullpathname,updatetime

Example 3: Retrieve unreplicated changes count to display

This command retrieves the total count of unreplicated changes between the downstream computer SRV02 and the upstream computer SRV01 for the replication group RG01 and the replicated folder RF01. The command displays this output in the verbose stream.


PS C:\> Get-DfsrBacklog -GroupName "RG01" -FolderName "RF01" -SourceComputerName "SRV01" -DestinationComputerName "SRV02" –Verbose

Example 4: Retrieve unreplicated changes count to a string object

This command retrieves the total count of unreplicated changes between the downstream computer SRV02 and the upstream computer SRV01 for the replication group RG01 and the replicated folder RF01. The command converts the verbose stream data into a text string containing only the count, for later manipulation.


PS C:\> (Get-DfsrBacklog -GroupName "RG01" -FolderName "RF01" -SourceComputerName "SRV01" -DestinationComputerName "SRV02" -Verbose 4>&1).Message.Split(':')[2] 

Example 5: Retrieve unreplicated changes count to a file

This command retrieves the total count of unreplicated changes between the downstream computer SRV02 and the upstream computer SRV01 for the replication group RG01 and the replicated folder RF01. The command converts the verbose stream data into a text string containing only the count, for later manipulation.


PS C:\> Get-DfsrBacklog -GroupName "RG01" -FolderName "RF01" -SourceComputerName "SRV01" -DestinationComputerName "SRV02" -Verbose 4> verbose.txt > null
PS C:\> Get-Content .\verbose.txt

Community Additions

ADD
Show: