|
| 1 | +--- |
| 2 | +title: netsh mbn |
| 3 | +description: The netsh mbn command manages Mobile Broadband (MBN) interfaces, cellular modems, and SIM-based network connections in Windows. |
| 4 | +ms.topic: reference |
| 5 | +ms.author: alalve |
| 6 | +author: xelu86 |
| 7 | +ms.date: 10/09/2025 |
| 8 | +--- |
| 9 | + |
| 10 | +# netsh mbn |
| 11 | + |
| 12 | +The `netsh mbn` command is used to configure, monitor, and troubleshoot Mobile Broadband (MBN) interfaces, including cellular modems and SIM-based network connections. It provides a range of options for managing profiles, connections, radio states, and advanced settings for mobile broadband devices on Windows. |
| 13 | + |
| 14 | +The **WWAN AutoConfig** service must be running on your device for certain commands and parameters to function. |
| 15 | + |
| 16 | +## Syntax |
| 17 | + |
| 18 | +``` |
| 19 | +netsh mbn [add | connect | delete | disconnect | dump | help | set | show | test | ?] |
| 20 | +``` |
| 21 | + |
| 22 | +``` |
| 23 | +netsh mbn add dmprofile [interface=]<string> [name=]<string> |
| 24 | +netsh mbn add profile [interface=]<string> [name=]<string> |
| 25 | +``` |
| 26 | + |
| 27 | +``` |
| 28 | +netsh mbn connect [interface=]<string> [connmode=]tmp|name [name=]<string> |
| 29 | +``` |
| 30 | + |
| 31 | +``` |
| 32 | +netsh mbn delete dmprofile [interface=]<string> [name=]<string> |
| 33 | +netsh mbn delete profile [interface=]<string> [name=]<string> |
| 34 | +``` |
| 35 | + |
| 36 | +``` |
| 37 | +netsh mbn disconnect [interface=]<string> |
| 38 | +``` |
| 39 | + |
| 40 | +``` |
| 41 | +netsh mbn set acstate [interface=]<string> [state=]autooff|autoon|manualoff|manualon |
| 42 | +netsh mbn set dataenablement [interface=]<string> [profileset=]internet|mms|all [mode=]yes|no |
| 43 | +netsh mbn set dataroamcontrol [interface=]<string> [profileset=]internet|mms|all [state=]none|partner|all |
| 44 | +netsh mbn set enterpriseapnparams [interface=]<string> [allowusercontrol=]yes|no|nc [allowuserview=]yes|no|nc |
| 45 | + [profileaction=]add|delete|modify|nc |
| 46 | +netsh mbn set highestconncategory [interface=]<string> [highestcc=]admim|user|operator|device |
| 47 | +netsh mbn set powerstate [interface=]<string> [state=]on|off |
| 48 | +netsh mbn set profileparameter [name=]<string> [[interface=]<string>] [cost]=default|unrestricted|fixed|variable |
| 49 | +netsh mbn set slotmapping [interface=]<string> [slotindex=]<integer> |
| 50 | +netsh mbn set tracing [mode=]yes|no |
| 51 | +``` |
| 52 | + |
| 53 | +``` |
| 54 | +netsh mbn show acstate [interface=]<string> |
| 55 | + basestationinfo [interface=]<string> |
| 56 | + capability [interface=]<string> |
| 57 | + connection [interface=]<string> |
| 58 | + d3cold [interface=]<string> |
| 59 | + dataenablement [interface=]<string> |
| 60 | + dataroamcontrol [interface=]<string> |
| 61 | + dmprofiles [name=]<string> [interface=]<string> |
| 62 | + enterpriseapnparams [interface=]<string> |
| 63 | + highestconncategory [interface=]<string> |
| 64 | + homeprovider [interface=]<string> |
| 65 | + interfaces |
| 66 | + McmInfo [interface=]<string> |
| 67 | + netlteattachinfo [interface=]<string> |
| 68 | + pin [interface=]<string> |
| 69 | + pinlist [interface=]<string> |
| 70 | + preferredproviders [interface=]<string> |
| 71 | + profiles [name=]<string> [interface=]<string> [purpose=]<string> |
| 72 | + profilestate [interface=]<string> [name=]<string> |
| 73 | + provisionedcontexts [interface=]<string> [name=]<string> |
| 74 | + purpose |
| 75 | + radio [interface=]<string> |
| 76 | + readyinfo [interface=]<string> [slotindex=]<integer> |
| 77 | + signal [interface=]<string> |
| 78 | + slotmapping [interface=]<string> |
| 79 | + slotstatus [interface=]<string> |
| 80 | + smsconfig [interface=]<string> |
| 81 | + tracing |
| 82 | + UICCCardAdditionalInfoWithEFHPLMNwAct [interface=]<string> |
| 83 | + visibleproviders [interface=]<string> |
| 84 | +``` |
| 85 | + |
| 86 | +``` |
| 87 | +netsh mbn test [feature=<feature area>] [testPath=<path>] [taefPath=<path>] [param=<test input params>] |
| 88 | +``` |
| 89 | + |
| 90 | +## Parameters |
| 91 | + |
| 92 | +| Command | Description | |
| 93 | +|--|--| |
| 94 | +| mbn `add` | `dmprofile` - Adds a Mobile Broadband Device Management Config Profile for the given interface for all users: <br> `interface` - The interface name. <br> `name` - The XML profile name. <br><br> `profile` - Adds a Mobile Broadband Network Profile for the given interface for all users: <br> `interface` - The interface name. <br> `name` - The XML profile name. <br><br> The `interface` and `name` parameters are required. | |
| 95 | +| mbn `connect` | Connects to a Mobile Broadband Network using a specified profile. The device must be registered before running this command. The `interface` parameter is required. <br><br> `connmode` - Determines how connection parameters are provided: <br> - `tmp`: Use a profile XML file for a temporary connection. <br> - `name`: Use a profile that was previously stored with the `netsh mbn add profile` command. <br><br> `name` - If `connmode` is set to `tmp`, specify the profile XML file name. If `connmode` is set to `name`, specify the stored profile name. | |
| 96 | +| mbn `delete` | `dmprofile` - Removes a Mobile Broadband Device Management Config Profile for the given interface. <br> `interface` - The interface name. <br> `name` - The XML profile name. <br><br> `profile` - Removes a Mobile Broadband Network Profile from the given interface: <br> `interface` - The interface name. <br> `name` - The XML profile name. <br><br> The `interface` and `name` parameters are required. | |
| 97 | +| mbn `disconnect` | Disconnects from the Mobile Broadband Network on the specified interface: <br> `interface` - The interface name. <br><br> The `interface` parameter is required. | |
| 98 | +| mbn `dump` | Creates a script containing the current context configuration. The script can be saved to a file and used to restore settings if they're altered or need to be replicated on another system. | |
| 99 | +| mbn `set` | Configures one of the following settings: <br><br> `acstate` - Configures the auto-connect behavior for Mobile Broadband data on the interface. The parameters `interface` and `state` are required. <br> `state` - Configures one of the following values: <br> - `autooff`: Turns auto connect token off. <br> - `autoon`: Turns auto-connect token on. <br> - `manualoff`: Turns off the manual connect token. <br> - `manualon`: Turns on the manual connect token. <br><br> `dataenablement` - Enables or disables Mobile Broadband data for a specified profile set and interface. The parameters `interface`, `profileset`, and `mode` are required. <br> `profileset` - Is the name of the profile set: <br> - `internet`, `mms`, or `all` <br> - `mode`: Enables (`yes`) or disables (`no`) the target profile set. <br><br> `dataroamcontrol` - Adjusts data roaming settings for Mobile Broadband on the selected profile set and interface. The parameters `interface`, `profileset`, and `mode` are required. <br> `profileset` - Is the name of the profile set: <br> - `internet`, `mms`, or `all` <br> - `state`: Applies changes to the home carrier only (`none`), home and partner carriers only (`partner`), or home, partner, and roaming carriers (`all`). <br><br> `enterpriseapnparams` - Modifies enterprise Access Point Name (APN) parameters for Mobile Broadband on the specified interface. The parameters `interface`, `allowusercontrol`, `allowuserview`, and `profileaction` are required. <br> - `allowusercontrol`: Allows (`yes`) or disallows (`no`) end user control of enterpriseAPN. Use `nc` to leave at default state. <br> - `allowuserview`: Allows (`yes`) or disallows (`no`) end user view of enterpriseAPN. Use `nc` to leave at default state. <br> - `profileaction`: Adds (`add`), deletes (`delete`) or modifies (`modify`) an enterpriseAPN profile. Use `nc` to leave at default state. <br><br> `highestconncategory` - Specifies the highest allowed connection category for Mobile Broadband on the given interface. The parameters `interface` and `highestcc` are required. <br> - Sets one of the provisioned profile types: <br> - `admin` <br> - `user` <br> - `operator` <br> - `device` <br><br> `powerstate` - Switches the Mobile Broadband radio on or off for the specified interface. The parameters `interface` and `state` are required. <br> `state`: Enables (`yes`) or disables (`no`) the radio transceiver. <br><br> `profileparameter` - Updates parameters within a Mobile Broadband Network Profile. The `name` parameter and at least one other parameter, such as `interface` or `cost`, must be specified. <br> - `name`: The profile name to be modified. <br> - `interface`: The interface name. <br> - `cost`: The cost associated with the profile. <br><br> `slotmapping` - Assigns modem slot mapping for Mobile Broadband on the specified interface. The parameters `interface` and `slotindex` are required. <br> - `interface`: The interface name. <br> - `slotindex`: The interface slot index number to be set. <br><br> `tracing` - Turns tracing on or off for Mobile Broadband operations. The `mode` parameter is required. <br> - `mode`: Enables (`yes`) or (`disables`) tracing for the Mobile Broadband. | |
| 100 | +| mbn `show` | Displays on of the following information: <br><br> `acstate interface=` - Displays the auto connect state for Mobile Broadband data on the specified interface. <br><br> `basestationinfo interface=` - Displays base station information for the specified interface. <br><br> `capability interface=` - Displays capability details for the specified interface. <br><br> `connection interface=` - Displays current connection details for the specified interface. <br><br> `d3cold interface=` - Indicates whether the modem supports D3Cold power state for the specified interface. <br><br> `dataenablement interface=` - Displays the data enablement status for the specified interface. <br><br> `dataroamcontrol interface=` - Displays the data roaming control status for the specified interface. <br><br> `dmprofiles` - Lists Direct Management Config profiles configured on the system. Use the `name` and `interface` parameters to filter for specific profiles on certain interfaces. <br><br> `enterpriseapnparams interface=` - Displays enterprise APN parameters for the specified interface. <br><br> `highestconncategory interface=` - Displays the highest connection category for the specified interface. <br><br> `homeprovider interface=` - Displays home provider details for the specified interface. <br><br> `interfaces` - Lists all Mobile Broadband interfaces on the system. <br><br> `McmInfo interface=` - Displays MCM-related information for the specified interface. <br><br> `netlteattachinfo interface=` - Displays LTE attach information for the specified interface. <br><br> `pin interface=` - Displays PIN information for the specified interface. <br><br> `pinlist interface=` - Displays the list of PINs for the specified interface. <br><br> `preferredproviders interface=` - Displays the list of preferred providers for the specified interface. <br><br> `profiles` - Lists all configured profiles on the system. Use the `name` and `interface` parameters to filter for specific profiles on certain interfaces. If `purpose` is provided, only profiles with the matching purpose GUID are displayed. The following strings are acceptable: <br> - `GUID` <br> - `internet` <br> - `supl` <br> - `mms` <br> - `ims` <br> - `allhost` <br><br>`profilestate` - Displays the state of a profile for the specified interface. The `interface` and `name` parameters are required. <br><br> `provisionedcontexts interface=` - Displays provisioned context information for the specified interface. <br><br> `purpose` - Displays available purpose group GUIDs. <br><br> `radio interface=` - Displays radio state information for the specified interface. <br><br> `readyinfo` - Displays readiness information for the specified interface. The `interface` parameter is required while `slotindex` is optional. <br><br> `signal interface=` - Displays signal strength and quality for the specified interface. <br><br> `slotmapping interface=` - Displays modem slot mapping for the specified interface. <br><br> `slotstatus interface=` - Displays modem slot status for the specified interface. <br><br> `smsconfig interface=` - Displays SMS configuration details for the specified interface. <br><br> `tracing` - Indicates whether tracing is enabled or disabled. <br><br> `UICCCardAdditionalInfoWithEFHPLMNwAct interface=` - Displays EFInfo in UICC for the specified interface. <br><br> `visibleproviders interface=` - Displays the list of visible providers for the specified interface. | |
| 101 | +| mbn `test` | Performs mobile broadband testing operations. <br><br> `feature` (required) - Is the feature area: <br> - `connectivity` <br> - `power` <br> - `radio` <br> - `esim` <br> - `esimhlk` <br> - `sms` <br> - `dssa` <br> - `lte` <br> - `bringup` <br> - `nr` <br> `testpath` - Is the path containing the test binaries. <br> `taefpath` - Is the path containing the TAEF binaries. <br> `param` - Tests other fields using colon separated values: <br> - `connectivity`, `radio`, or `bringup`: The `AccessString` or `UserName` (if applicable), and `Password` (if applicable). <br> - `esim`: The `ActivationCode`. <br><br> The `testPath` and `taefPath` parameters are optional on amd64 devices where HLK Server is installed. | |
| 102 | +| mbn `help` or `?` | Displays a list of commands and their descriptions in the current context. | |
| 103 | + |
| 104 | +## Remarks |
| 105 | + |
| 106 | +- Values given to the `interface` parameter must be wrapped in double quotes (**" "**) for interface names containing a space. |
| 107 | + |
| 108 | +- If you're in the `mbn` context, you can run `show interfaces` to display all interface names. |
| 109 | + |
| 110 | +## Examples |
| 111 | + |
| 112 | +To add a Device Management profile for the mobile broadband interface named "Cellular", with the profile name "EnterpriseDM", run the following command: |
| 113 | + |
| 114 | +```cmd |
| 115 | +netsh mbn add dmprofile interface=Cellular name=EnterpriseDM |
| 116 | +``` |
| 117 | + |
| 118 | +To connect the mobile broadband interface "Cellular" using a temporary profile XML file named "temp_profile.xml", run the following command: |
| 119 | + |
| 120 | +```cmd |
| 121 | +netsh mbn connect interface=Cellular connmode=tmp name=temp_profile.xml |
| 122 | +``` |
| 123 | + |
| 124 | +To disconnect the mobile broadband interface "Cellular", run the following command: |
| 125 | + |
| 126 | +```cmd |
| 127 | +netsh mbn disconnect interface=Cellular |
| 128 | +``` |
| 129 | + |
| 130 | +To turn on auto-connect for the "Cellular" interface, run the following command: |
| 131 | + |
| 132 | +```cmd |
| 133 | +netsh mbn set acstate interface=Cellular state=autoon |
| 134 | +``` |
| 135 | + |
| 136 | +To add an enterprise APN profile for the "Cellular" interface, allowing user control, and view, run the following command: |
| 137 | + |
| 138 | +```cmd |
| 139 | +netsh mbn set enterpriseapnparams interface=Cellular allowusercontrol=yes allowuserview=yes profileaction=add |
| 140 | +``` |
| 141 | + |
| 142 | +To display the tracing status for Mobile Broadband commands, run the following command: |
| 143 | + |
| 144 | +```cmd |
| 145 | +netsh mbn show tracing |
| 146 | +``` |
| 147 | + |
| 148 | +To perform a connectivity test with the AccessString "internet", run the following command: |
| 149 | + |
| 150 | +```cmd |
| 151 | +netsh mbn test feature=connectivity param="AccessString=internet" |
| 152 | +``` |
| 153 | + |
| 154 | +To perform an eSIM test that selects the DSSA category, run the following command: |
| 155 | + |
| 156 | +```cmd |
| 157 | +netsh mbn test feature=esim param="/select:\"(@Category='DSSA')\"" |
| 158 | +``` |
| 159 | + |
| 160 | +## See also |
| 161 | + |
| 162 | +- [Command-Line Syntax Key](command-line-syntax-key.md) |
![learn-build-service-prod[bot]](https://avatars.githubusercontent.com/in/237442?v=4&size=40){kind=avatar}
0 commit comments