PowerShell Logo Small

Set-BCMinSMBLatency



This is the built-in help made by Microsoft for the command 'Set-BCMinSMBLatency', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 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 [<SwitchParameter>]] [-CimSession <CimSession>] [-Force [<SwitchParameter>]]
[-PolicyStore <String>] [-ThrottleLimit <Int32>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<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

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.