该 netsh branchcache 命令在 Windows 中使用，用于管理 BranchCache，该功能可加快对分支机构中数据的访问速度。
Syntax
netsh branchcache dump | exportkey | flush | help | importkey | reset | set | show | smb | ?
netsh branchcache exportkey [outputfile=]<File Path> [passphrase]=<Pass Phrase>
netsh branchcache importkey [inputfile=]<File Path> [passphrase]=<Pass Phrase>
netsh branchcache set [cachesize | key | localcache | publicationcache | publicationcachesize | service]
netsh branchcache set [cachesize | publicationcachesize] [size=]{DEFAULT|<number>} [[percent=]{TRUE|FALSE}]
netsh branchcache set key [[passphrase=]<Pass Phrase>]
netsh branchcache set [localcache | publicationcache] [directory=]{DEFAULT|<File Path>}
netsh branchcache set service [mode=]{DISABLED|LOCAL|DISTRIBUTED|HOSTEDSERVER|HOSTEDCLIENT}
[[location]=<Host Name>]
[[clientauthentication]={DOMAIN|NONE}]
[[serveonbattery]={TRUE|FALSE}]
netsh branchcache show [hostedcache | localcache | publicationcache | status]
netsh branchcache show status [[detail=]{BASIC|ALL}]
netsh branchcache smb [dump | help | set | show]
netsh branchcache smb set [latency=]<number>
Parameters
| Parameter | Description |
|---|---|
| 转储 | 转储设备上与 BranchCache 相关的配置详细信息和设置。 |
exporty键 <FilePath>\<FileName><Passphrase> |
导出 BranchCache 服务用于保护内容信息的密钥。 稍后可以使用该命令在另一台设备 importkey 上导入密钥。 输出文件是应导出密钥的文件的目录路径和名称。 导入密钥需要通行短语。 |
| 刷新 | 清除或删除 BranchCache 存储在设备上的内容的本地缓存。 |
| 帮助 还是 ？ | 显示给定命令的帮助信息。 |
导入键 <FilePath>\<FileName><Passphrase> |
导入 BranchCache 服务的密钥，以用于保护内容信息。 必须先使用 exportkey 命令导出密钥。 如果服务当前正在运行，此命令将重新启动它以开始使用新密钥。 |
| 复位/重设/还原 | 重启 BranchCache 服务，并清除客户端和任何本地存储的发布数据上的内容缓存。 此命令将配置设置重置为其默认设置。 |
set [cachesize | publicationcachesize] [size=]{DEFAULT|<number>}[[percent=]{TRUE|FALSE}] |
cachesize - 设置本地缓存的大小。 publicationcachesize - 设置本地发布缓存的大小。 size - 指示缓存大小（以百分比或确切 <number> 字节为单位）。 如果设置为 default，则还原默认配置。 percent - 指定大小值是解释为硬盘大小的百分比还是以字节的确切 <number> 字节为单位。 如果大小值设置为 default，则忽略此参数。 True - 指示大小是硬盘大小的百分比。 False - 指示大小是确切的字节数（默认选项）。 |
| 设置键 [[密码=]<密码>] | 键 - 生成新的内容信息密钥。 密码用于生成密钥。 如果未提供通行短语，则会生成随机密钥。 如果使用同一密码生成的两个密钥，则它们相同。 密码可用于在另一台设备上复制同一密钥。 |
| set [localcache | publicationcache] [directory=]{DEFAULT|<文件路径>} | localcache - 设置本地缓存的位置。 publicationcache - 设置本地发布缓存的位置。 directory - 是要在其中存储本地缓存或发布缓存的目录的路径。 设置为 |
| 设置服务 [mode=]{DISABLED |LOCAL |DISTRIBUTED |HOSTEDSERVER |HOSTEDCLIENT} [[location]=<主机名>] [[clientauthentication]={DOMAIN|NONE}] [[serveonbattery]={TRUE|FALSE}] | mode - 配置 BranchCache 服务模式。 disabled - 禁用 BranchCache 服务。 local - 仅允许在本地设备上缓存数据。 distributed - 激活分布式缓存，允许在对等配置中的多台计算机上缓存数据。 hostedserver - 将设备设置为托管缓存服务器，以向客户端提供缓存数据。 hostedclient - 将设备设置为托管缓存服务器的客户端，以接收和存储缓存的数据。 location - 设置托管缓存服务器的位置，仅当模式设置为 hostedclient 其他模式并且在其他模式下被忽略时才是必需的。 clientauthentication - 设置托管缓存服务器用于对连接的客户端进行身份验证的方法。 仅当模式设置为 hostedserver 且被忽略时，此参数才相关。 domain - 要求客户端成为与托管缓存服务器相同的域的成员进行身份验证。 none - 没有为客户端实现身份验证方法。 serveonbattery - 允许本地客户端在电池供电时响应缓存数据的对等请求。 仅当模式设置为 distributed 且被忽略时，此参数才适用。 true - 使服务程序能够在电池时提供缓存的数据。 false - 在电池供电时禁用缓存数据请求的服务。 |
| 显示 [hostedcache | localcache | publicationcache | status] |
hostedcache - 如果设备设置为充当托管缓存服务器，则显示托管缓存服务器的配置信息状态。 localcache - 提供有关设备上的本地缓存的详细信息，例如硬盘和缓存位置上的缓存大小。 publicationcache - 显示有关发布缓存设置和内容的信息。 status - 提供当前 BranchCache 配置和作状态的摘要，包括模式 BranchCache 设置为。 |
显示状态 [[detail=]{BASIC|ALL}] |
detail - 指定所显示信息的详细信息级别。 basic - 仅显示基本信息（默认选项）。 all - 显示可用的综合信息。 |
| smb [dump] smb [set | show] 延迟 [latency=]\ <number> |
管理与服务器消息块 （SMB） 协议相关的 BranchCache 设置。 dump - 输出表示当前配置设置的脚本。 set - 修改或分配特定配置参数的值。 show - 显示当前配置参数及其值。 latency - 在 SMB 使用 BranchCache 进行缓存之前，指定到分支机构的最小链接延迟（以毫秒为单位）。 |
Examples
dump
若要将 BranchCache 配置转储到文件，请键入以下命令：
netsh branchcache dump > C:\BranchCacheConfig.txt
exportkey
若要将客户端密钥导出到文件，请键入以下命令：
netsh branchcache exportkey C:\Keys\BranchCacheKey.bckey
若要导出具有密码的特定密钥，请键入以下命令：
netsh branchcache exportkey C:\Keys\BranchCacheKey.bckey mypassword
flush
若要清除所有缓存的内容，请键入以下命令：
netsh branchcache flush
help
若要显示特定 BranchCache 命令（如 exportkey）的帮助，请键入以下命令：
netsh branchcache exportkey help
Note
命令 help 和 ? 命令可互换使用。
importkey
若要从文件中导入 BranchCache 密钥，请键入以下命令：
netsh branchcache importkey C:\Keys\BranchCacheKey.bckey
若要从具有密码的文件导入密钥，请键入以下命令：
netsh branchcache importkey C:\Keys\BranchCacheKey.bckey mypassword
reset
若要将 BranchCache 重置为其默认状态，请键入以下命令：
netsh branchcache reset
set
若要将 BranchCache 模式设置为 distributed，请键入以下命令：
netsh branchcache set mode=distributed
若要将缓存大小设置为特定百分比，例如 10%，请键入以下命令：
netsh branchcache set cachesize=10%
若要将客户端配置为使用托管缓存服务器，请键入以下命令：
netsh branchcache set service mode=HOSTEDCLIENT location=HOSTEDSERVERNAME
show
若要显示 Current BranchCache 状态，请键入以下命令：
netsh branchcache show status
若要显示 Current BranchCache 配置，请键入以下命令：
netsh branchcache show configuration
smb
若要将延迟阈值设置为 80 毫秒，请键入以下命令：
netsh branchcache smb set latency=80