netsh branchcache

Der netsh branchcache Befehl wird in Windows verwendet, um BranchCache zu verwalten, ein Feature, das den Zugriff auf Daten in Zweigstellen beschleunigt.

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	Speichert die Konfigurationsdetails und Einstellungen im Zusammenhang mit BranchCache auf Ihrem Gerät.
exportykey <FilePath>\<FileName><Passphrase>	Exportiert den Schlüssel, den der BranchCache-Dienst zum Schützen von Inhaltsinformationen verwendet. Der Schlüssel kann später mithilfe des importkey Befehls auf einem anderen Gerät importiert werden. Die Ausgabedatei ist ein Verzeichnispfad und der Name der Datei, in die der Schlüssel exportiert werden soll. Die Passphrase ist erforderlich, um den Schlüssel zu importieren.
flush	Löscht oder löscht den lokalen Cache von Inhalten, die BranchCache auf Ihrem Gerät speichert.
hilfe oder ?	Zeigt Hilfeinformationen für den angegebenen Befehl an.
Importkey <FilePath>\<FileName><Passphrase>	Importiert einen Schlüssel für den BranchCache-Dienst zum Schützen von Inhaltsinformationen. Der Schlüssel muss zuvor mithilfe des exportkey Befehls exportiert werden. Wenn der Dienst derzeit ausgeführt wird, startet dieser Befehl ihn neu, um mit der Verwendung des neuen Schlüssels zu beginnen.
reset	Startet den BranchCache-Dienst neu und löscht sowohl den Inhaltscache auf der Clientseite als auch alle lokal gespeicherten Publikationsdaten. Mit diesem Befehl werden die Konfigurationseinstellungen auf ihre Standardeinstellungen zurückgesetzt.
[cachesize | publicationcachesize] [size=]{DEFAULT|<number>} festlegen [[percent=]{TRUE|FALSE}]	cachesize – Legt die Größe des lokalen Caches fest. publicationcachesize – Legt die Größe des lokalen Publikationscaches fest. size - Gibt die Cachegröße als Prozentsatz oder eine genaue <number> Byte an. Bei Festlegung auf defaultwird die Standardkonfiguration wiederhergestellt. Prozent – Gibt an, ob der Größenwert als Prozentsatz der Festplattengröße oder in exakten <number> Byte interpretiert wird. Dieser Parameter wird ignoriert, wenn der Größenwert auf default. True - Gibt an, dass die Größe ein Prozentsatz der Größe der Festplatte ist. False - Gibt an, dass die Größe eine genaue Anzahl von Bytes ist (Standardoption).
schlüssel [[passphrase=]<Passphrase>] festlegen	key – Generiert einen neuen Inhaltsinformationsschlüssel. Eine Passphrase wird verwendet, um den Schlüssel zu generieren. Wenn keine Passphrase bereitgestellt wird, wird ein Zufälliger Schlüssel generiert. Wenn zwei Schlüssel, die mit derselben Passphrase generiert werden, identisch sind. Eine Passphrase kann verwendet werden, um denselben Schlüssel auf einem anderen Gerät zu duplizieren.
[localcache | publicationcache] [directory=]{DEFAULT|<Dateipfad>}	localcache – Legt den Speicherort des lokalen Caches fest. publicationcache – Legt den Speicherort des lokalen Publikationscaches fest. verzeichnis – Ist der Pfad zum Verzeichnis, in dem der lokale Cache oder der Publikationscache gespeichert werden soll. Bei Festlegung auf default, wird der Standardcachespeicherort wiederhergestellt. Dieser Dienst wird bei Bedarf neu gestartet, um die Änderung abzuschließen. Alle vorhandenen Cachedateien werden an den neuen Speicherort verschoben.
Dienst festlegen [mode=]{DISABLED | LOKAL | VERTEILT | HOSTEDSERVER | HOSTEDCLIENT} [[location]=<Host Name>] [[clientauthentication]={DOMAIN|NONE}] [[serveonbattery]={TRUE|FALSE}]	modus : Konfiguriert den BranchCache-Dienstmodus. disabled – Deaktiviert den BranchCache-Dienst. local – Ermöglicht nur das Zwischenspeichern von Daten auf dem lokalen Gerät. distributed – Aktiviert die verteilte Zwischenspeicherung, sodass Daten in einer Peer-to-Peer-Konfiguration auf mehreren Computern zwischengespeichert werden können. hostedserver – Legt das Gerät als gehosteten Cacheserver fest, um zwischengespeicherte Daten an Clients zu bedienen. hostedclient – Legt das Gerät als Client eines gehosteten Cacheservers fest, um zwischengespeicherte Daten zu empfangen und zu speichern. location – Legt den Speicherort des gehosteten Cacheservers fest, der nur erforderlich ist, wenn der Modus auf andere Modi festgelegt hostedclient und ignoriert wird. clientauthentication – Legt die Methode fest, die von einem gehosteten Cacheserver verwendet wird, um verbundene Clients zu authentifizieren. Dieser Parameter ist nur relevant, wenn der Modus auf den Modus festgelegt hostedserver und andernfalls ignoriert wird. domain – Erfordert, dass Clients Mitglieder derselben Domäne wie der gehostete Cacheserver für die Authentifizierung sind. none - Für Clients ist keine Authentifizierungsmethode implementiert. serveonbattery – Ermöglicht dem lokalen Client, auf Peeranforderungen für zwischengespeicherte Daten zu reagieren, während der Akkubetrieb ausgeführt wird. Dieser Parameter gilt nur, wenn der Modus auf den Modus festgelegt distributed und andernfalls ignoriert wird. true – Ermöglicht es dem Dienst, zwischengespeicherte Daten während des Akkus bereitzustellen. false – Deaktiviert die Wartung von zwischengespeicherten Datenanforderungen bei Akkubetrieb.
show [hostedcache | localcache | publicationcache | status]	hostedcache – Zeigt den Konfigurationsinformationsstatus des gehosteten Cacheservers an, wenn das Gerät für eine Funktion eingerichtet ist. localcache – Enthält Details zum lokalen Cache auf dem Gerät, z. B. die Größe des Caches auf der Festplatte und den Cachespeicherort. publicationcache – Zeigt Informationen zu den Einstellungen und Inhalten des Publikationscaches an. status – Enthält eine Zusammenfassung der aktuellen BranchCache-Konfiguration und des Betriebsstatus, einschließlich des Modus BranchCache, auf den sie festgelegt ist.
Status anzeigen [[detail=]{BASIC|ALL}]	detail – Gibt die Detailebene für die angezeigten Informationen an. basic - Zeigt nur wichtige Informationen an (Standardoption). all – Zeigt umfassende Verfügbare Informationen an.
smb [dump] smb [set | show] latenz [latenz=]\<number>	Verwaltet die BranchCache-Einstellungen im Zusammenhang mit dem Server Message Block (SMB)-Protokoll. dump – Gibt ein Skript aus, das die aktuellen Konfigurationseinstellungen darstellt. set – Ändert oder weist bestimmten Konfigurationsparametern Werte zu. show – Zeigt die aktuellen Konfigurationsparameter und deren Werte an. latency – Gibt die minimale Verknüpfungslatenz in Millisekunden an die Zweigstelle an, bevor SMB BranchCache zum Zwischenspeichern verwendet.

Examples

dump

Geben Sie den folgenden Befehl ein, um die BranchCache-Konfiguration in eine Datei zu speichern:

netsh branchcache dump > C:\BranchCacheConfig.txt

exportkey

Geben Sie den folgenden Befehl ein, um den Clientschlüssel in eine Datei zu exportieren:

netsh branchcache exportkey C:\Keys\BranchCacheKey.bckey

Um einen bestimmten Schlüssel mit einem Kennwort zu exportieren, geben Sie den folgenden Befehl ein:

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

flush

Um alle zwischengespeicherten Inhalte zu löschen, geben Sie den folgenden Befehl ein:

netsh branchcache flush

help

Geben Sie den folgenden Befehl ein, um Hilfe für einen bestimmten BranchCache-Befehl anzuzeigen, z. B. exportkey:

netsh branchcache exportkey help

Note

Sowohl die Befehle als auch befehle help? werden austauschbar verwendet.

importkey

Um einen BranchCache-Schlüssel aus einer Datei zu importieren, geben Sie den folgenden Befehl ein:

netsh branchcache importkey C:\Keys\BranchCacheKey.bckey

Um einen Schlüssel aus einer Datei mit einem Kennwort zu importieren, geben Sie den folgenden Befehl ein:

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

reset

Um BranchCache auf den Standardzustand zurückzusetzen, geben Sie den folgenden Befehl ein:

netsh branchcache reset

set

Geben Sie den folgenden Befehl ein, um den BranchCache-Modus auf "BranchCache" distributedfestzulegen:

netsh branchcache set mode=distributed

Geben Sie den folgenden Befehl ein, um die Cachegröße auf einen bestimmten Prozentsatz festzulegen, z 10%. B. den folgenden Befehl:

netsh branchcache set cachesize=10%

Um einen Client für die Verwendung eines gehosteten Cacheservers zu konfigurieren, geben Sie den folgenden Befehl ein:

netsh branchcache set service mode=HOSTEDCLIENT location=HOSTEDSERVERNAME

show

Geben Sie den folgenden Befehl ein, um den aktuellen BranchCache-Status anzuzeigen:

netsh branchcache show status

Geben Sie den folgenden Befehl ein, um die aktuelle BranchCache-Konfiguration anzuzeigen:

netsh branchcache show configuration

smb

Geben Sie den folgenden Befehl ein, um den Latenzschwellenwert auf 80 Millisekunden festzulegen:

netsh branchcache smb set latency=80

See also

• BranchCache

• BranchCache PowerShell-Modul