PowerShell Logo Small

Set-BCMinSMBLatency



This is the built-in help made by Microsoft for the command 'Set-BCMinSMBLatency', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Sets the minimum latency that must exist between client and server before transparent caching functions are utilized.

SYNTAX


Set-BCMinSMBLatency [-LatencyMilliseconds] <UInt32> [-AsJob] [-CimSession <CimSession[]>] [-Force] [-ThrottleLimit <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Set-BCMinSMBLatency cmdlet sets the minimum latency that must exist between client and server before transparent caching functions are utilized. Use this cmdlet to
specify when client computers in branch offices start caching content from content servers based on the network latency, or delay, that occurs when the clients download
content over a Wide Area Network (WAN) link. When a value for this cmdlet is specified, which is the maximum round trip network latency allowed before caching begins,
clients do not cache content until the network latency reaches the specified value; when network latency is greater than the value, clients begin caching content after they
receive it from the content servers.


For example, if the round trip network latency value is set to zero (0), the client computers always cache content that they receive from the content servers, no matter how
high or low the network latency is between their request for a file and their receipt of the file from the content server. In another example, if the round trip network
latency value is set to 100 milliseconds, then the clients do not cache content that they receive before 100 milliseconds pass, but they do begin to cache content that they
receive after 100 milliseconds pass.


By default, the value of this setting is 80 milliseconds. To ensure that client computers always cache content, set the network latency value to 0.


To prevent caching except in circumstances where network latency is extremely long, set the latency value to a very high value. If a high value is used, however, then it is
possible that network latency will not reach this long a delay, in which case BranchCache is disabled on your network.


Whether this setting is disabled or not configured, the client computer will cache network files if the round trip network latency of the wide area network (WAN) link is
above 80 milliseconds.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?linkid=287295
Disable-BC
Reset-BC

REMARKS

<

Examples


EXAMPLE 1

PS C:\>Set-BCMinSMBLatency -LatencyMilliseconds 20



This example sets the minimum latency that must exist between client and server before transparent caching functions are utilized to 20 milliseconds.