netsh mbn 명령

적용 대상: Windows Server 2022, Windows Server 2019, Windows Server 2016, Azure Stack HCI, 버전 21H2 및 20H2

netsh mbn을 사용하여 모바일 광대역 설정 및 매개 변수를 쿼리하고 구성합니다.

팁

다음을 사용하여 netsh mbn 명령에 대한 도움말을 볼 수 있습니다.

       netsh mbn /?

사용 가능한 netsh mbn 명령은 다음과 같습니다.

• add
• connect
• delete
• disconnect
• diagnose
• dump
• help
• set
• show
• 테스트.

추가

구성 항목을 테이블에 추가합니다.

사용 가능한 netsh mbn add 명령은 다음과 같습니다.

• dmprofile
• profile

dmprofile

DM 구성 프로필을 프로필 데이터 저장소에 추가합니다.

구문

add dmprofile [interface=]<string> [name=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
name	프로필 XML 파일의 이름입니다. 프로필 데이터가 포함된 XML 파일의 이름입니다.	필수

예제

add dmprofile interface="Cellular" name="Profile1.xml"

profile

네트워크 프로필을 프로필 데이터 저장소에 추가합니다.

구문

add profile [interface=]<string> [name=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
name	프로필 XML 파일의 이름입니다. 프로필 데이터가 포함된 XML 파일의 이름입니다.	필수

예제

add profile interface="Cellular" name="Profile1.xml"

connect

모바일 광대역 네트워크에 연결합니다.

구문

connect [interface=]<string> [connmode=]tmp|name [name=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
connmode	연결 매개 변수를 제공하는 방법을 지정합니다. 프로필 XML을 사용하거나, 이전에 "netsh mbn add profile" 명령을 통해 이전에 모바일 광대역 프로필 데이터 저장소에 저장한 프로필 XML의 프로필 이름을 사용하여 연결을 요청할 수 있습니다. 전자의 경우 connmode 매개 변수는 값으로 "tmp"를 포함해야 합니다. 반면, 후자의 경우 "name"이어야 합니다.	필수
name	프로필 XML 파일의 이름입니다. 프로필 데이터가 포함된 XML 파일의 이름입니다.	필수

예제

connect interface="Cellular" connmode=tmp name=d:\profile.xml
connect interface="Cellular" connmode=name name=MyProfileName

삭제

테이블에서 구성 항목을 추가합니다.

사용 가능한 netsh mbn delete 명령은 다음과 같습니다.

• dmprofile
• profile

dmprofile

프로필 데이터 저장소에서 DM 구성 프로필을 삭제합니다.

구문

delete dmprofile [interface=]<string> [name=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
name	프로필 XML 파일의 이름입니다. 프로필 데이터가 포함된 XML 파일의 이름입니다.	필수

예제

delete dmprofile interface="Cellular" name="myProfileName"

profile

프로필 데이터 저장소에서 네트워크 프로필을 삭제합니다.

구문

delete profile [interface=]<string> [name=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
name	프로필 XML 파일의 이름입니다. 프로필 데이터가 포함된 XML 파일의 이름입니다.	필수

예제

delete profile interface="Cellular" name="myProfileName"

diagnose

기본 셀룰러 문제에 대한 진단을 실행합니다.

구문

diagnose [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

diagnose interface="Cellular"

연결 끊기

모바일 광대역 네트워크에서 연결을 끊습니다.

구문

disconnect [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

disconnect interface="Cellular"

dump

구성 스크립트를 표시합니다.

현재 구성이 포함된 스크립트를 만듭니다. 파일에 저장되면 이 스크립트를 사용하여 변경된 구성 설정을 복원할 수 있습니다.

구문

dump

도움말

명령 목록을 표시합니다.

구문

help

설정

구성 정보를 설정합니다.

사용 가능한 netsh mbn set 명령은 다음과 같습니다.

• acstate
• dataenablement
• dataroamcontrol
• enterpriseapnparams
• highestconncategory
• powerstate
• profileparameter
• slotmapping
• tracing

acstate

지정한 인터페이스의 모바일 광대역 데이터 자동 연결 상태를 설정합니다.

구문

set acstate [interface=]<string> [state=]autooff|autoon|manualoff|manualon

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
name	설정할 자동 연결 상태입니다. 다음 값 중 하나입니다. autooff: 자동 연결 토큰 끄기입니다. autoon: 자동 연결 토큰 켜기입니다. manualoff: 수동 연결 토큰 끄기입니다. manualon: 수동 연결 토큰 켜기입니다.	필수

예제

set acstate interface="Cellular" state=autoon

dataenablement

지정한 프로필 세트 및 인터페이스의 모바일 광대역 데이터를 설정하거나 해제합니다.

구문

set dataenablement [interface=]<string> [profileset=]internet|mms|all [mode=]yes|no

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
profileset	프로필 세트의 이름입니다.	필수
mode	다음 값 중 하나입니다. yes: 대상 프로필 세트를 사용하도록 설정합니다. 아니요: 대상 프로필 세트를 사용하지 않도록 설정합니다.	필수

예제

set dataenablement interface="Cellular" profileset=mms mode=yes

dataroamcontrol

지정한 프로필 세트 및 인터페이스의 모바일 광대역 데이터 로밍 제어 상태를 설정합니다.

구문

set dataroamcontrol [interface=]<string> [profileset=]internet|mms|all [state=]none|partner|all

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
profileset	프로필 세트의 이름입니다.	필수
mode	다음 값 중 하나입니다. none: 홈 통신 회사만 partner: 홈 및 파트너 통신 회사만 all: 홈, 파트너 및 로밍 통신 회사	필수

예제

set dataroamcontrol interface="Cellular" profileset=mms mode=partner

enterpriseapnparams

지정한 인터페이스의 모바일 광대역 데이터 enterpriseAPN 매개 변수를 설정합니다.

구문

set enterpriseapnparams [interface=]<string> [allowusercontrol=]yes|no|nc [allowuserview=]yes|no|nc [profileaction=]add|delete|modify|nc

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
allowusercontrol	다음 값 중 하나입니다. yes: 사용자가 enterpriseAPN을 제어하도록 허용합니다. no: 사용자가 enterpriseAPN을 제어하도록 허용하지 않습니다. nc: 변경되지 않습니다.	필수
allowuserview	다음 값 중 하나입니다. yes: 사용자가 enterpriseAPN을 보도록 허용합니다. no: 사용자가 enterpriseAPN을 보도록 허용하지 않습니다. nc: 변경되지 않습니다.	필수
profileaction	다음 값 중 하나입니다. add: enterpriseAPN 프로필이 추가됩니다. delete: enterpriseAPN 프로필이 삭제됩니다. modify: enterpriseAPN 프로필이 수정됩니다. nc: 변경되지 않습니다.	필수

예제

set enterpriseapnparams interface="Cellular" profileset=mms mode=yes

highestconncategory

지정한 인터페이스의 모바일 광대역 데이터 최고 연결 범주를 설정합니다.

구문

set highestconncategory [interface=]<string> [highestcc=]admim|user|operator|device

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
highestcc	다음 값 중 하나입니다. admin: 관리자가 프로비전한 프로필입니다. user: 사용자가 프로비전한 프로필입니다. operator: 운영자가 프로비전한 프로필입니다. device: 디바이스가 프로비전한 프로필입니다.	필수

예제

set highestconncategory interface="Cellular" highestcc=operator

powerstate

지정된 인터페이스의 모바일 광대역 송수신 장치를 켜거나 끕니다.

구문

set powerstate [interface=]<string> [state=]on|off

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
state	다음 값 중 하나입니다. on: 송수신 장치의 전원을 켭니다. off: 라디오 트랜시버 전원을 끕니다.	필수

예제

set powerstate interface="Cellular" state=on

profileparameter

모바일 광대역 네트워크 프로필의 매개 변수를 설정합니다.

구문

set profileparameter [name=]<string> [[interface=]<string>] [[cost]=default|unrestricted|fixed|variable]

매개 변수

매개 변수	Description	요구 사항
name	수정할 프로필의 이름입니다. 인터페이스를 지정하면 해당 인터페이스의 프로필만 수정됩니다.	필수
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	선택
cost	프로필과 관련된 비용입니다.	선택

설명

인터페이스 이름과 비용 사이에 하나 이상의 매개 변수를 지정해야 합니다.

예제

set profileparameter name="profile 1" cost=default

slotmapping

지정한 인터페이스의 모바일 광대역 모뎀 슬롯 매핑을 설정합니다.

구문

set slotmapping [interface=]<string> [slotindex=]<integer>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
slotindex	설정할 슬롯 인덱스입니다.	필수

예제

set slotmapping interface="Cellular" slotindex=1

tracing

추적을 사용하거나 사용하지 않도록 설정합니다.

구문

set tracing [mode=]yes|no

매개 변수

매개 변수	Description	요구 사항
mode	다음 값 중 하나입니다. yes: 모바일 광대역 추적을 사용하도록 설정합니다. 아니요: 모바일 광대역 추적을 사용하지 않도록 설정합니다.	필수

예제

set tracing mode=yes

show

모바일 광대역 네트워크 정보를 표시합니다.

사용 가능한 netsh mbn show 명령은 다음을 보여줍니다.

• acstate
• capability
• connection
• dataenablement
• dataroamcontrol
• dmprofiles
• enterpriseapnparams
• highestconncategory
• homeprovider
• interfaces
• netlteattachinfo
• pin
• pinlist
• preferredproviders
• profiles
• profilestate
• provisionedcontexts
• purpose
• radio
• readyinfo
• signal
• slotmapping
• slotstatus
• smsconfig
• tracing
• visibleproviders

acstate

지정한 인터페이스의 모바일 광대역 데이터 자동 연결 상태를 표시합니다.

구문

show acstate [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show acstate interface="Cellular"

capability

지정한 인터페이스의 인터페이스 기능 정보를 표시합니다.

구문

show capability [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show capability interface="Cellular"

connection

지정한 인터페이스의 현재 연결 정보를 표시합니다.

구문

show connection [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show connection interface="Cellular"

dataenablement

지정한 인터페이스의 모바일 광대역 데이터 사용 상태를 표시합니다.

구문

show dataenablement [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show dataenablement interface="Cellular"

dataroamcontrol

지정한 인터페이스의 모바일 광대역 데이터 로밍 제어 상태를 표시합니다.

구문

show dataroamcontrol [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show dataroamcontrol interface="Cellular"

dmprofiles

시스템에 구성되어 있는 DM 구성 프로필 목록을 표시합니다.

구문

show dmprofiles [[name=]<string>] [[interface=]<string>]

매개 변수

매개 변수	Description	요구 사항
name	표시할 프로필의 이름입니다.	선택
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	선택

설명

프로필 데이터를 표시하거나 시스템의 프로필을 나열합니다.

프로필 이름을 지정하면 해당 프로필의 내용이 표시됩니다. 그렇지 않으면 인터페이스의 프로필이 나열됩니다.

인터페이스 이름을 지정하면 지정한 인터페이스의 해당 프로필만 나열됩니다. 그렇지 않으면 일치하는 첫 번째 프로필이 표시됩니다.

예제

show dmprofiles name="profile 1" interface="Cellular"
show dmprofiles name="profile 2"
show dmprofiles

enterpriseapnparams

지정한 인터페이스의 모바일 광대역 데이터 enterpriseAPN 매개 변수를 표시합니다.

구문

show enterpriseapnparams [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show enterpriseapnparams interface="Cellular"

highestconncategory

지정한 인터페이스의 모바일 광대역 데이터 최고 연결 범주를 표시합니다.

구문

show highestconncategory [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show highestconncategory interface="Cellular"

homeprovider

지정한 인터페이스의 홈 공급자 정보를 표시합니다.

구문

show homeprovider [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show homeprovider interface="Cellular"

interfaces

시스템의 모바일 광대역 인터페이스 목록을 표시합니다. 이 명령에는 매개 변수가 없습니다.

구문

show interfaces

netlteattachinfo

지정한 인터페이스의 모바일 광대역 네트워크 LTE 연결 정보를 표시합니다.

구문

show netlteattachinfo [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show netlteattachinfo interface="Cellular"

고정

지정한 인터페이스의 PIN 정보를 표시합니다.

구문

show pin [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show pin interface="Cellular"

pinlist

지정한 인터페이스의 PIN 목록 정보를 표시합니다.

구문

show pinlist [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show pinlist interface="Cellular"

preferredproviders

지정한 인터페이스의 기본 공급자 목록을 표시합니다.

구문

show preferredproviders [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show preferredproviders interface="Cellular"

profiles

시스템에 구성되어 있는 프로필 목록을 표시합니다.

구문

show profiles [[name=]<string>] [[interface=]<string>] [[purpose=]<string>]

매개 변수

매개 변수	Description	요구 사항
name	표시할 프로필의 이름입니다.	선택
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	선택
purpose	용도	선택

설명

프로필 이름을 지정하면 해당 프로필의 내용이 표시됩니다. 그렇지 않으면 인터페이스의 프로필이 나열됩니다.

인터페이스 이름을 지정하면 지정한 인터페이스의 해당 프로필만 나열됩니다. 그렇지 않으면 일치하는 첫 번째 프로필이 표시됩니다.

용도가 제공되면 용도 GUID가 일치하는 프로필만 표시됩니다. 그렇지 않으면 프로필이 용도를 기준으로 필터링되지 않습니다. 문자열은 중괄호로 묶인 GUID이거나 internet, supl, mms, ims 또는 allhost라는 문자열 중 하나일 수 있습니다.

예제

show profiles interface="Cellular" purpose="{00000000-0000-0000-0000-000000000000}"
show profiles name="profile 1" interface="Cellular"
show profiles name="profile 2"
show profiles

profilestate

지정한 인터페이스의 모바일 광대역 프로필 상태를 표시합니다.

구문

show profilestate [interface=]<string> [name=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수
name	프로필 이름입니다. 표시할 상태가 있는 프로필의 이름입니다.	필수

예제

show profilestate interface="Cellular" name="myProfileName"

provisionedcontexts

지정한 인터페이스의 프로비저닝된 컨텍스트 정보를 표시합니다.

구문

show provisionedcontexts [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show provisionedcontexts interface="Cellular"

purpose

디바이스의 프로필을 필터링하는 데 사용할 수 있는 용도 그룹 GUID를 표시합니다. 이 명령에는 매개 변수가 없습니다.

구문

show purpose

radio

지정한 인터페이스의 송수신 장치 상태 정보를 표시합니다.

구문

show radio [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show radio interface="Cellular"

readyinfo

지정한 인터페이스의 준비 상태 정보를 표시합니다.

구문

show readyinfo [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show readyinfo interface="Cellular"

signal

지정한 인터페이스의 신호 정보를 표시합니다.

구문

show signal [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show signal interface="Cellular"

slotmapping

지정한 인터페이스의 모바일 광대역 모뎀 슬롯 매핑을 표시합니다.

구문

show slotmapping [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show slotmapping interface="Cellular"

slotstatus

지정한 인터페이스의 모바일 광대역 모뎀 슬롯 상태를 표시합니다.

구문

show slotstatus [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show slotstatus interface="Cellular"

smsconfig

지정한 인터페이스의 SMS 구성 정보를 표시합니다.

구문

show smsconfig [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show smsconfig interface="Cellular"

tracing

모바일 광대역 추적 기능의 사용 여부를 표시합니다.

구문

show tracing

visibleproviders

지정한 인터페이스의 표시 공급자 목록을 표시합니다.

구문

show visibleproviders [interface=]<string>

매개 변수

매개 변수	Description	요구 사항
interface	인터페이스 이름입니다. "netsh mbn show interface" 명령으로 표시되는 인터페이스 이름 중 하나입니다.	필수

예제

show visibleproviders interface="Cellular"

test

로그를 수집하면서 특정 기능 영역에 대한 테스트를 실행합니다.

구문

test [feature=<feature area>] [testPath=<path>] [taefPath=<path>] [param=<test input params>]

매개 변수

태그	값	선택 사항 여부
feature	아래 나열된 지원되는 기능 영역 중 기능 영역	필수
testpath	테스트 바이너리를 포함하는 경로	HLK 서버가 설치된 경우 선택 사항
taefpath	TAEF 바이너리를 포함하는 경로	HLK 서버가 설치된 경우 선택 사항
param	쉼표로 구분된 매개 변수, 테스트에 사용	특정 기능 영역에는 필수, 다른 영역에는 선택 사항

주의

지원되는 기능 영역은 다음과 같습니다.

• 연결
• power
• radio
• esim
• sms
• dssa
• lte
• bringup

일부 테스트는 param 필드에 제공할 추가 매개 변수가 필요합니다. 기능에 필요한 매개 변수는 다음과 같습니다.

• connectivity: AccessString, UserName(해당하는 경우), Password(해당하는 경우)
• radio: AccessString, UserName(해당하는 경우), Password(해당하는 경우)
• esim: ActivationCode
• bringup: AccessString, UserName(해당하는 경우), Password(해당하는 경우)

예

test feature=connectivity param="AccessString=internet"
test feature=lte testpath="C:\\data\\test\\bin" taefpath="C:\\data\\test\\bin"
test feature=lte