이 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 |
|---|---|
| dump | 디바이스에서 BranchCache와 관련된 구성 세부 정보 및 설정을 덤프합니다. |
내보내기키 <FilePath>\<FileName><Passphrase> |
BranchCache 서비스에서 콘텐츠 정보를 보호하는 데 사용하는 키를 내보냅니다. 나중에 명령을 사용하여 importkey 다른 디바이스에서 키를 가져올 수 있습니다. 출력 파일은 키를 내보내야 하는 파일의 디렉터리 경로 및 이름입니다. 키를 가져오려면 암호가 필요합니다. |
| flush | BranchCache가 디바이스에 저장하는 콘텐츠의 로컬 캐시를 지우거나 삭제합니다. |
| 도움말 또는 ? | 지정된 명령에 대한 도움말 정보를 표시합니다. |
가져오기 키 <FilePath>\<FileName><Passphrase> |
콘텐츠 정보를 보호하는 데 사용할 BranchCache 서비스의 키를 가져옵니다. 키를 이전에 명령을 사용하여 exportkey 내보내야 합니다. 서비스가 현재 실행 중인 경우 이 명령은 새 키 사용을 시작하기 위해 다시 시작합니다. |
| reset | BranchCache 서비스를 다시 시작하고 클라이언트 쪽의 콘텐츠 캐시와 로컬로 저장된 게시 데이터를 모두 지웁니다. 이 명령은 구성 설정을 기본 설정으로 다시 설정합니다. |
[캐시 크기 | 출판 캐시 크기] [크기=]{기본값|<number>} 설정 [[퍼센트=]{TRUE|FALSE}] |
cachesize - 로컬 캐시의 크기를 설정합니다. publicationcachesize - 로컬 게시 캐시의 크기를 설정합니다. size - 캐시 크기를 백분율 또는 정확한 <number> 바이트로 나타냅니다. 설정 default하면 기본 구성이 복원됩니다. percent - 크기 값이 하드 디스크 크기의 백분율로 해석되는지 또는 정확한 <number> 바이트 단위로 해석되는지를 지정합니다. 크기 값이 .로 설정된 default경우 이 매개 변수는 무시됩니다. True - 크기가 하드 디스크 크기의 백분율임을 나타냅니다. False - 크기가 정확한 바이트 수임을 나타냅니다(기본 옵션). |
| 키 설정 [[암호=]<암호>] | key - 새 콘텐츠 정보 키를 생성합니다. 암호를 사용하여 키를 생성합니다. 암호를 제공하지 않으면 임의 키가 생성됩니다. 동일한 암호를 사용하여 생성된 두 개의 키는 동일합니다. 암호를 사용하여 다른 디바이스에서 동일한 키를 복제할 수 있습니다. |
| set [localcache | publicationcache] [directory=]{DEFAULT|<파일 경로>} | localcache - 로컬 캐시의 위치를 설정합니다. publicationcache - 로컬 게시 캐시의 위치를 설정합니다. 디렉터리 - 로컬 캐시 또는 게시 캐시를 저장해야 하는 디렉터리의 경로입니다. 로 default설정하면 기본 캐시 위치가 복원됩니다. 이 서비스는 필요한 경우 변경을 완료하기 위해 다시 시작됩니다. 기존 캐시 파일은 새 위치로 이동됩니다. |
| 서비스 설정 [모드=]{비활성화 | 지역 | 분산 | 호스팅 서버 | HOSTEDCLIENT} [[위치]=<호스트 이름>] [[클라이언트 인증]={도메인|없음}] [[serveonbattery]={TRUE|거짓}] | mode - BranchCache 서비스 모드를 구성합니다. disabled - BranchCache 서비스를 사용하지 않도록 설정합니다. local - 로컬 디바이스에서만 데이터 캐싱을 사용하도록 설정합니다. distributed - 분산 캐싱을 활성화하여 피어 투 피어 구성에서 여러 컴퓨터에 데이터를 캐시할 수 있습니다. hostedserver - 클라이언트에 캐시된 데이터를 제공하도록 디바이스를 호스트 캐시 서버로 설정합니다. hostedclient - 호스트 캐시 서버의 클라이언트로 디바이스를 설정하여 캐시된 데이터를 수신하고 저장합니다. ___location - 호스트 캐시 서버의 위치를 설정합니다. 이 위치는 모드가 다른 모드로 hostedclient 설정되고 다른 모드에서 무시되는 경우에만 필요합니다. clientauthentication - 호스트 캐시 서버에서 연결된 클라이언트를 인증하는 데 사용하는 메서드를 설정합니다. 이 매개 변수는 모드가 설정된 hostedserver 경우에만 관련이 있으며, 그렇지 않으면 무시됩니다. ___domain - 인증을 위해 클라이언트가 Hosted Cache Server와 동일한 도메인의 멤버여야 합니다. 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
exportkey와 같은 특정 BranchCache 명령에 대한 도움말을 표시하려면 다음 명령을 입력합니다.
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
현재 BranchCache 상태를 표시하려면 다음 명령을 입력합니다.
netsh branchcache show status
현재 BranchCache 구성을 표시하려면 다음 명령을 입력합니다.
netsh branchcache show configuration
smb
대기 시간 임계값을 밀리초로 80 설정하려면 다음 명령을 입력합니다.
netsh branchcache smb set latency=80