通过

Netsh 移动宽带网络命令

  • 项目

适用于：Windows Server 2022、Windows Server 2019、Windows Server 2016，Azure Stack HCI 版本 21H2 和 20H2

可以使用 netsh mbn 查询和配置移动宽带网络 (MBN) 设置和参数。

提示

可以使用以下项获取有关 netsh mbn 命令的帮助

netsh mbn /?

可用的 netsh mbn 命令为：

添加

将配置项添加到表中。

可用的 netsh mbn add 命令包括：

dmprofile

在配置文件数据存储中添加 DM Config 配置文件。

语法

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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
name 配置文件 XML 文件的名称。 包含配置文件数据的 XML 文件的名称。 必须

示例

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

profile

在配置文件数据存储中添加网络配置文件。

语法

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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
name 配置文件 XML 文件的名称。 包含配置文件数据的 XML 文件的名称。 必须

示例

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

connect

连接到移动宽带网络。

语法

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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
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

从配置文件数据存储中删除 DM Config 配置文件。

语法

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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
name 配置文件 XML 文件的名称。 包含配置文件数据的 XML 文件的名称。 必须

示例

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

profile

从配置文件数据存储中删除网络配置文件。

语法

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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
name 配置文件 XML 文件的名称。 包含配置文件数据的 XML 文件的名称。 必须

示例

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

diagnose

针对基本手机网络问题运行诊断。

语法

diagnose [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

diagnose interface="Cellular"

断开连接

从移动宽带网络断开连接。

语法

disconnect [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

disconnect interface="Cellular"

dump

显示配置脚本。

创建包含当前配置的脚本。 如果将此脚本保存到某个文件，则可以使用此脚本来还原已更改的配置设置。

语法

dump

help

显示命令列表。

语法

help

设置

设置配置信息。

可用的 netsh mbn set 命令为：

acstate

设置给定接口的移动宽带数据自动连接状态。

语法

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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
name 要设置的自动连接状态。 以下值之一：
autooff：自动连接标记关闭。
autoon：自动连接标记打开。
manualoff：手动连接标记关闭。
manualon：手动连接标记打开。		 必须

示例

set acstate interface="Cellular" state=autoon

dataenablement

对给定的配置文件集和接口打开或关闭移动宽带数据。

语法

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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
profileset 配置文件集的名称。 必需
mode 以下值之一：
yes：启用目标配置文件集。
no：禁用目标配置文件集。		 必须

示例

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

dataroamcontrol

设置给定配置文件集和接口的移动宽带数据漫游控制状态。

语法

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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
highestcc 以下值之一：
admin：管理员预配的配置文件。
user：用户预配的配置文件。
operator：操作员预配的配置文件。
device：设备预配的配置文件。		 必须

示例

set highestconncategory interface="Cellular" highestcc=operator

powerstate

对给定的接口打开或关闭移动宽带无线电。

语法

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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
state 以下值之一：
on：打开无线电收发器的电源。
off：关闭无线电收发器的电源。		 必须

示例

set powerstate interface="Cellular" state=on

profileparameter

在移动宽带网络配置文件中设置参数。

语法

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

参数

参数 说明 要求
name 要修改的配置文件的名称。 如果指定了接口，则只修改该接口上的配置文件。 必需
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 可选
cost 与配置文件关联的成本。 可选

备注

必须在接口名称与成本之间至少指定一个参数。

示例

set profileparameter name="profile 1" cost=default

slotmapping

设置给定接口的移动宽带调制解调器插槽映射。

语法

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

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
slotindex 要设置的插槽索引。 必需

示例

set slotmapping interface="Cellular" slotindex=1

tracing

启用或禁用跟踪。

语法

set tracing [mode=]yes|no

参数

参数 说明 要求
mode 以下值之一：
yes：启用移动宽带跟踪。
no：禁用移动宽带跟踪。		 必须

示例

set tracing mode=yes

显示

显示移动宽带网络信息。

可用的 netsh mbn show 命令为：

acstate

显示给定接口的移动宽带数据自动连接状态。

语法

show acstate [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show acstate interface="Cellular"

capability

显示给定接口的接口功能信息。

语法

show capability [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show capability interface="Cellular"

connection

显示给定接口的当前连接信息。

语法

show connection [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show connection interface="Cellular"

dataenablement

显示给定接口的移动宽带数据启用状态。

语法

show dataenablement [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show dataenablement interface="Cellular"

dataroamcontrol

显示给定接口的移动宽带数据漫游控制状态。

语法

show dataroamcontrol [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show dataroamcontrol interface="Cellular"

dmprofiles

显示系统上配置的 DM Config 配置文件列表。

语法

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

参数

参数 说明 要求
name 要显示的配置文件的名称。 可选
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 可选

备注

显示配置文件数据或列出系统上的配置文件。

如果指定了配置文件名称，则会显示配置文件的内容。 否则会列出接口的配置文件。

如果指定了接口名称，则只会列出给定接口上的指定配置文件。 否则会显示第一个匹配的配置文件。

示例

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

enterpriseapnparams

显示给定接口的移动宽带数据 enterpriseAPN 参数。

语法

show enterpriseapnparams [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show enterpriseapnparams interface="Cellular"

highestconncategory

显示给定接口的移动宽带数据最高连接类别。

语法

show highestconncategory [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show highestconncategory interface="Cellular"

homeprovider

显示给定接口的本地提供商信息。

语法

show homeprovider [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show homeprovider interface="Cellular"

interfaces

显示系统上的移动宽带接口列表。 此命令没有参数。

语法

show interfaces

netlteattachinfo

显示给定接口的移动宽带网络 LTE 附加信息。

语法

show netlteattachinfo [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show netlteattachinfo interface="Cellular"

固定

显示给定接口的引脚信息。

语法

show pin [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show pin interface="Cellular"

pinlist

显示给定接口的引脚列表信息。

语法

show pinlist [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show pinlist interface="Cellular"

preferredproviders

显示给定接口的首选提供商列表。

语法

show preferredproviders [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show preferredproviders interface="Cellular"

profiles

显示系统上配置的配置文件列表。

语法

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

参数

参数 说明 要求
name 要显示的配置文件的名称。 可选
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 可选
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>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必需
name 配置文件的名称。 具有要显示状态的配置文件的名称。 必须

示例

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

provisionedcontexts

显示给定接口的预配上下文信息。

语法

show provisionedcontexts [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show provisionedcontexts interface="Cellular"

purpose

显示可用于在设备上筛选配置文件的用途组 GUID。 此命令没有参数。

语法

show purpose

radio

显示给定接口的无线电状态信息。

语法

show radio [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show radio interface="Cellular"

readyinfo

显示给定接口的就绪状态信息。

语法

show readyinfo [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show readyinfo interface="Cellular"

signal

显示给定接口的信号信息。

语法

show signal [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show signal interface="Cellular"

slotmapping

显示给定接口的移动宽带调制解调器插槽映射。

语法

show slotmapping [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show slotmapping interface="Cellular"

slotstatus

显示给定接口的移动宽带调制解调器插槽状态。

语法

show slotstatus [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show slotstatus interface="Cellular"

smsconfig

显示给定接口的短信配置信息。

语法

show smsconfig [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show smsconfig interface="Cellular"

tracing

显示是启用还是禁用了移动宽带跟踪。

语法

show tracing

visibleproviders

显示给定接口的可视提供商列表。

语法

show visibleproviders [interface=]<string>

参数

参数 说明 要求
interface 接口名称。 netsh mbn show interfaces 命令显示的接口名称之一。 必须

示例

show visibleproviders interface="Cellular"

测试

为特定功能区域运行测试，同时收集日志。

语法

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

Parameters

标记 值 是否可选？
feature 以下备注部分列出的受支持功能区域中的一个功能区域 必须
testpath 包含测试二进制文件的路径 如果安装了 HLK 服务器，为可选
taefpath 包含测试 TAEF 二进制文件的路径 如果安装了 HLK 服务器，为可选
param 以逗号分隔的参数，将用于测试 对某些功能区域为必选，对其他功能区域为可选

备注

支持的功能区域为：

  • 连接
  • power
  • radio
  • esim
  • sms
  • dssa
  • lte
  • bringup

一些测试要求在 param 字段中提供更多的参数。 下面是功能必需的参数：

  • connectivity：AccessString、UserName（如果适用）、密码（如果适用）
  • radio：AccessString、UserName（如果适用）、密码（如果适用）
  • esim：ActivationCode
  • bringup：AccessString、UserName（如果适用）、密码（如果适用）

示例

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