Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La netsh branchcache commande est utilisée dans Windows pour gérer BranchCache, une fonctionnalité qui accélère l’accès aux données dans les filiales.
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 |
|---|---|
| dump | Vide les détails et les paramètres de configuration associés à BranchCache sur votre appareil. |
exportykey <FilePath>\<FileName><Passphrase> |
Exporte la clé utilisée par le service BranchCache pour protéger les informations de contenu. La clé peut être importée ultérieurement sur un autre appareil à l’aide de la importkey commande. Le fichier de sortie est un chemin d’accès de répertoire et un nom du fichier dans lequel la clé doit être exportée. La phrase secrète est requise pour importer la clé. |
| flush | Efface ou supprime le cache local du contenu que BranchCache stocke sur votre appareil. |
| aide ou ? | Affiche des informations d’aide pour la commande donnée. |
importkey <FilePath>\<FileName><Passphrase> |
Importe une clé pour le service BranchCache à utiliser pour protéger les informations de contenu. La clé doit être précédemment exportée à l’aide de la exportkey commande. Si le service est en cours d’exécution, cette commande le redémarre pour commencer à utiliser la nouvelle clé. |
| reset | Redémarre le service BranchCache et efface le cache de contenu côté client et toutes les données de publication stockées localement. Cette commande réinitialise les paramètres de configuration à leurs paramètres par défaut. |
set [cachesize | publicationcachesize] [size=]{DEFAULT|<number>} [[pourcentage=]{TRUE|FALSE}] |
cachesize : définit la taille du cache local. publicationcachesize : définit la taille du cache de publication local. taille : indique la taille du cache sous la forme d’un pourcentage ou d’un nombre exact <number> d’octets. Si la valeur est définie default, la configuration par défaut est restaurée. pourcentage : spécifie si la valeur de taille est interprétée comme un pourcentage de la taille du disque dur ou dans l’exact <number> des octets. Ce paramètre est ignoré si la valeur de taille est définie sur default. True : indique que la taille est un pourcentage de la taille du disque dur. False - Indique que la taille est un nombre exact d’octets (option par défaut). |
| set key [[passphrase=]Phrase<> de passe] | clé : génère une nouvelle clé d’informations de contenu. Une phrase secrète est utilisée pour générer la clé. Si une phrase secrète n’est pas fournie, une clé aléatoire est générée. Si deux clés générées à l’aide de la même phrase secrète, elles sont identiques. Une phrase secrète peut être utilisée pour dupliquer la même clé sur un autre appareil. |
| set [localcache | publicationcache] [directory=]{DEFAULT|<Chemin d’accès au> fichier} | localcache : définit l’emplacement du cache local. publicationcache : définit l’emplacement du cache de publication local. répertoire : chemin d’accès au répertoire dans lequel le cache local ou le cache de publication doit être stocké. Lorsqu’il est défini defaultsur , il restaure l’emplacement du cache par défaut. Ce service est redémarré, si nécessaire, pour terminer la modification. Tous les fichiers de cache existants sont déplacés vers le nouvel emplacement. |
| set service [mode=]{DISABLED | LOCAL | DISTRIBUTED | HOSTEDSERVER | HOSTEDCLIENT} [[location]=<Nom> d’hôte] [[clientauthentication]={DOMAINE|NONE}] [[serveonbattery]={TRUE|FALSE}] | mode : configure le mode de service BranchCache. disabled - Désactive le service BranchCache. local - Active la mise en cache des données sur l’appareil local uniquement. distributed - Active la mise en cache distribuée, ce qui permet aux données d’être mises en cache sur plusieurs ordinateurs dans une configuration d’égal à égal. hostedserver - Définit l’appareil en tant que serveur de cache hébergé pour servir les données mises en cache aux clients. hostedclient - Définit l’appareil en tant que client d’un serveur de cache hébergé pour recevoir et stocker des données mises en cache. emplacement : définit l’emplacement du serveur de cache hébergé, ce qui est nécessaire uniquement si le mode est défini hostedclient et est ignoré dans d’autres modes. clientauthentication : définit la méthode utilisée par un serveur de cache hébergé pour authentifier les clients connectés. Ce paramètre n’est pertinent que lorsque le mode est défini hostedserver et est ignoré dans le cas contraire. domain - Nécessite que les clients soient membres du même domaine que le serveur de cache hébergé pour l’authentification. none - Aucune méthode d’authentification n’est implémentée pour les clients. serveonbattery : permet au client local de répondre aux demandes d’homologue pour les données mises en cache tout en fonctionnant sur batterie. Ce paramètre s’applique uniquement lorsque le mode est défini distributed et est ignoré dans le cas contraire. true - Permet au servicer de fournir des données mises en cache pendant la batterie. false - Désactive la maintenance des demandes de données mises en cache quand l’alimentation de la batterie est activée. |
| show [HostedCache | localcache | publicationcache | status] |
hostedcache - Affiche l’état des informations de configuration du serveur de cache hébergé si l’appareil est configuré pour fonctionner comme un seul. localcache - Fournit des détails sur le cache local sur l’appareil, tels que la taille du cache sur le disque dur et l’emplacement du cache. publicationcache - Affiche des informations sur les paramètres et le contenu du cache de publication. status - Fournit un résumé de la configuration actuelle de BranchCache et de l’état opérationnel, y compris le mode BranchCache défini. |
afficher l’état [[detail=]{BASIC|ALL}] |
détail : spécifie le niveau de détail des informations affichées. basic - Affiche uniquement les informations essentielles (option par défaut). all - Affiche des informations complètes disponibles. |
| smb [dump] smb [set | show] latence [latence=]\ <number> |
Gère les paramètres BranchCache liés au protocole SMB (Server Message Block). dump - Génère un script qui représente les paramètres de configuration actuels. set - Modifie ou affecte des valeurs à des paramètres de configuration spécifiques. show - Affiche les paramètres de configuration actuels et leurs valeurs. latency - Spécifie la latence minimale de liaison, en millisecondes, vers la succursale avant que SMB n’utilise BranchCache pour la mise en cache. |
Examples
dump
Pour vider la configuration BranchCache dans un fichier, tapez la commande suivante :
netsh branchcache dump > C:\BranchCacheConfig.txt
exportkey
Pour exporter la clé cliente vers un fichier, tapez la commande suivante :
netsh branchcache exportkey C:\Keys\BranchCacheKey.bckey
Pour exporter une clé spécifique avec un mot de passe, tapez la commande suivante :
netsh branchcache exportkey C:\Keys\BranchCacheKey.bckey mypassword
flush
Pour effacer tout le contenu mis en cache, tapez la commande suivante :
netsh branchcache flush
help
Pour afficher de l’aide pour une commande BranchCache spécifique, telle que exportkey, tapez la commande suivante :
netsh branchcache exportkey help
Note
Les commandes et help les ? commandes sont utilisées de façon interchangeable.
importkey
Pour importer une clé BranchCache à partir d’un fichier, tapez la commande suivante :
netsh branchcache importkey C:\Keys\BranchCacheKey.bckey
Pour importer une clé à partir d’un fichier avec un mot de passe, tapez la commande suivante :
netsh branchcache importkey C:\Keys\BranchCacheKey.bckey mypassword
reset
Pour réinitialiser BranchCache à son état par défaut, tapez la commande suivante :
netsh branchcache reset
set
Pour définir le mode distributedBranchCache sur , tapez la commande suivante :
netsh branchcache set mode=distributed
Pour définir la taille du cache sur un pourcentage spécifique, par 10%exemple, tapez la commande suivante :
netsh branchcache set cachesize=10%
Pour configurer un client pour qu’il utilise un serveur de cache hébergé, tapez la commande suivante :
netsh branchcache set service mode=HOSTEDCLIENT location=HOSTEDSERVERNAME
show
Pour afficher l’état current BranchCache, tapez la commande suivante :
netsh branchcache show status
Pour afficher la configuration current BranchCache, tapez la commande suivante :
netsh branchcache show configuration
smb
Pour définir le seuil de latence sur 80 millisecondes, tapez la commande suivante :
netsh branchcache smb set latency=80