Get-DfsrBacklog
Get-DfsrBacklog
Retrieves the list of pending file updates between two DFS Replication partners.
構文
Parameter Set: Default
Get-DfsrBacklog [[-GroupName] <String[]> ] [[-FolderName] <String[]> ] [-SourceComputerName] <String> [-DestinationComputerName] <String> [ <CommonParameters>]
詳細説明
The Get-DfrsBacklog cmdlet retrieves pending updates between two computers that participate in 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.
パラメーター
-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.
エイリアス |
ReceivingMember,RMem |
必須? |
true |
位置は? |
4 |
既定値 |
[local computer] |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
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 (*).
エイリアス |
RF,RfName |
必須? |
false |
位置は? |
2 |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
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 specify multiple groups, separated by commas, as well as wildcard characters (*).
エイリアス |
RG,RgName |
必須? |
false |
位置は? |
1 |
既定値 |
なし |
パイプライン入力を許可する |
True (ByValue, ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SourceComputerName<String>
Specifies the name of the sending computer. A source computer is also called an outbound or upstream computer.
エイリアス |
SendingMember,SMem |
必須? |
true |
位置は? |
3 |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
- Microsoft.DistributedFileSystemReplication.DfsReplicationGroup, Microsoft.DistributedFileSystemReplication.DfsReplicatedFolder, string computerName
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
- Microsoft.DistributedFileSystemReplication.DfsrIdRecord
例
Example 12: Retrieve unreplicated changes between upstream and downstream computers1
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 23: Retrieve unreplicated changes count to display2
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 34: Retrieve unreplicated changes count to a string object3
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 45: Retrieve unreplicated changes count to a file4
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 > nullPS C:\> Get-Content .\verbose.txt