netsh branchcache

O netsh branchcache comando é usado no Windows para gerenciar o BranchCache, um recurso que acelera o acesso aos dados em filiais.

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
despejo	Despeja os detalhes de configuração e as configurações relacionadas ao BranchCache em seu dispositivo.
exportychave <FilePath>\<FileName><Passphrase>	Exporta a chave que o serviço BranchCache usa para proteger informações de conteúdo. A chave pode ser importada posteriormente em outro dispositivo usando o importkey comando. O arquivo de saída é um caminho de diretório e um nome do arquivo em que a chave deve ser exportada. A frase secreta é necessária para importar a chave.
liberar	Limpa ou exclui o cache local de conteúdo que o BranchCache armazena em seu dispositivo.
ajuda ou ?	Exibe informações de ajuda para o comando especificado.
chave de importação <FilePath>\<FileName><Passphrase>	Importa uma chave para o serviço BranchCache usar para proteger informações de conteúdo. A chave deve ser exportada anteriormente usando o exportkey comando. Se o serviço estiver em execução no momento, esse comando o reiniciará para começar a usar a nova chave.
redefinir	Reinicia o serviço BranchCache e limpa o cache de conteúdo no lado do cliente e todos os dados de publicação armazenados localmente. Esse comando redefine as configurações para suas configurações padrão.
set [cachesize | publicationcachesize] [size=]{DEFAULT|<number>} [[percent=]{TRUE|FALSE}]	cachesize - Define o tamanho do cache local. publicationcachesize - Define o tamanho do cache de publicação local. tamanho – indica o tamanho do cache como uma porcentagem ou uma exata <number> de bytes. Se definido como default, a configuração padrão será restaurada. porcentagem – especifica se o valor de tamanho é interpretado como uma porcentagem do tamanho do disco rígido ou exatamente <number> de bytes. Esse parâmetro será ignorado se o valor de tamanho for definido como default. True - Indica que o tamanho é uma porcentagem do tamanho do disco rígido. False - Indica que o tamanho é um número exato de bytes (opção padrão).
definir chave [[passphrase=]<Passphrase>]	chave – gera uma nova chave de informações de conteúdo. Uma frase secreta é usada para gerar a chave. Se uma frase secreta não for fornecida, uma chave aleatória será gerada. Se duas chaves geradas usando a mesma frase secreta, elas serão idênticas. Uma frase secreta pode ser usada para duplicar a mesma chave em outro dispositivo.
set [localcache | publicationcache] [directory=]{DEFAULT|<Caminho> do Arquivo}	localcache – Define o local do cache local. publicationcache - Define o local do cache de publicação local. diretório – É o caminho para o diretório no qual o cache local ou o cache de publicação deve ser armazenado. Quando definido como default, ele restaura o local de cache padrão. Esse serviço é reiniciado, se necessário, para concluir a alteração. Todos os arquivos de cache existentes são movidos para o novo local.
set service [mode=]{DISABLED | LOCAL | DISTRIBUTED | HOSTEDSERVER | HOSTEDCLIENT} [[location]=<Nome> do Host] [[clientauthentication]={DOMAIN|NONE}] [[serveonbattery]={TRUE|FALSE}]	modo – configura o modo de serviço BranchCache. disabled - Desabilita o serviço BranchCache. local – Habilita o cache de dados somente no dispositivo local. distributed – Ativa o cache distribuído, permitindo que os dados sejam armazenados em cache em vários computadores em uma configuração ponto a ponto. hostedserver - Define o dispositivo como um Servidor de Cache Hospedado para fornecer dados armazenados em cache aos clientes. hostedclient - Define o dispositivo como um cliente de um Servidor de Cache Hospedado para receber e armazenar dados armazenados em cache. local – Define o local do Servidor de Cache Hospedado, que só será necessário se o modo estiver definido hostedclient e for ignorado em outros modos. clientauthentication - Define o método usado por um Servidor de Cache Hospedado para autenticar clientes conectados. Esse parâmetro só é relevante quando o modo é definido hostedserver e ignorado de outra forma. domain – Requer que os clientes sejam membros do mesmo domínio que o Servidor de Cache Hospedado para autenticação. none – Nenhum método de autenticação é implementado para clientes. serveonbattery – permite que o cliente local responda a solicitações de par para dados armazenados em cache enquanto opera na energia da bateria. Esse parâmetro é aplicável somente quando o modo é definido distributed e ignorado de outra forma. true - Permite que o servicer forneça dados armazenados em cache durante a bateria. false - Desabilita a manutenção de solicitações de dados armazenadas em cache quando estiver na energia da bateria.
mostrar [hostedcache | localcache | publicationcache | status]	hostedcache – Exibe o status das informações de configuração do servidor cache hospedado se o dispositivo estiver configurado para funcionar como um. localcache - Fornece detalhes sobre o cache local no dispositivo, como o tamanho do cache no disco rígido e no local do cache. publicationcache - Mostra informações sobre as configurações e o conteúdo do cache de publicação. status - Fornece um resumo da configuração atual do BranchCache e do status operacional, incluindo o modo para o qual o BranchCache está definido.
mostrar status [[detail=]{BASIC|ALL}]	detalhe – especifica o nível de detalhes para as informações exibidas. basic - Mostra apenas informações essenciais (opção padrão). all – Exibe informações abrangentes disponíveis.
smb [dump] smb [set | show] latência [latência=]\<number>	Gerencia as configurações do BranchCache relacionadas ao protocolo SMB (Server Message Block). dump – Gera um script que representa as configurações atuais. set – Modifica ou atribui valores a parâmetros de configuração específicos. show – Exibe os parâmetros de configuração atuais e seus valores. latency - Especifica a latência mínima de vínculo, em milissegundos, para a filial antes que o SMB utilize o BranchCache para cache.

Examples

dump

Para despejar a configuração do BranchCache em um arquivo, digite o seguinte comando:

netsh branchcache dump > C:\BranchCacheConfig.txt

exportkey

Para exportar a chave do cliente para um arquivo, digite o seguinte comando:

netsh branchcache exportkey C:\Keys\BranchCacheKey.bckey

Para exportar uma chave específica com uma senha, digite o seguinte comando:

netsh branchcache exportkey C:\Keys\BranchCacheKey.bckey mypassword

flush

Para limpar todo o conteúdo armazenado em cache, digite o seguinte comando:

netsh branchcache flush

help

Para exibir ajuda para um comando específico do BranchCache, como exportkey, digite o seguinte comando:

netsh branchcache exportkey help

Note

Os comandos e os help comandos ? são usados de forma intercambiável.

importkey

Para importar uma chave BranchCache de um arquivo, digite o seguinte comando:

netsh branchcache importkey C:\Keys\BranchCacheKey.bckey

Para importar uma chave de um arquivo com uma senha, digite o seguinte comando:

netsh branchcache importkey C:\Keys\BranchCacheKey.bckey mypassword

reset

Para redefinir o BranchCache para seu estado padrão, digite o seguinte comando:

netsh branchcache reset

set

Para definir o modo BranchCache como distributed, digite o seguinte comando:

netsh branchcache set mode=distributed

Para definir o tamanho do cache como uma porcentagem específica, por 10%exemplo, digite o seguinte comando:

netsh branchcache set cachesize=10%

Para configurar um cliente para usar um servidor de cache hospedado, digite o seguinte comando:

netsh branchcache set service mode=HOSTEDCLIENT location=HOSTEDSERVERNAME

show

Para mostrar o status atual do BranchCache, digite o seguinte comando:

netsh branchcache show status

Para mostrar a configuração atual do BranchCache, digite o seguinte comando:

netsh branchcache show configuration

smb

Para definir o limite de latência como 80 milissegundos, digite o seguinte comando:

netsh branchcache smb set latency=80

See also

• BranchCache

• Módulo do PowerShell do BranchCache