Netsh-Befehle für das mobile Breitbandnetzwerk

Gilt für Windows Server 2022, Windows Server 2019, Windows Server 2016, Azure Stack HCI (Version 21H2 und 20H2)

Sie können mithilfe von netsh mbn MBN-Einstellungen und -Parameter (Mobile Broadband Network, mobiles Breitbandnetzwerk) abfragen und konfigurieren.

Tipp

Hilfe zum Befehl netsh mbn erhalten Sie mit folgendem Befehl:

netsh mbn /?

Die verfügbaren „netsh mbn“-Befehle sind:

hinzufügen

Fügt einen Konfigurationseintrag zu einer Tabelle hinzu.

Verfügbare netsh mbn add-Befehle:

dmprofile

Fügt ein DM-Konfigurationsprofil in den Profildatenspeicher ein.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
name Name der Profil-XML-Datei. Der Name der XML-Datei, die die Profildaten enthält. Erforderlich

Beispiel

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

Profil

Fügt ein Netzwerkprofil in den Profildatenspeicher ein.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
name Name der Profil-XML-Datei. Der Name der XML-Datei, die die Profildaten enthält. Erforderlich

Beispiel

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

connect

Stellt eine Verbindung mit einem mobilen Breitbandnetzwerk her.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
connmode Gibt an, wie Verbindungsparameter bereitgestellt werden. Sie können die Verbindung mithilfe einer Profil-XML oder mithilfe des Profilnamens für die Profil-XML anfordern, die zuvor im Profildatenspeicher für mobiles Breitband mit dem Befehl netsh mbn add profile gespeichert wurde. Im ersten Fall muss der Parameter „connmode“ den Wert tmp enthalten. Im letzteren Fall hingegen muss der Wert name lauten. Erforderlich
name Name der Profil-XML-Datei. Der Name der XML-Datei, die die Profildaten enthält. Erforderlich

Beispiele

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

löschen

Löscht einen Konfigurationseintrag aus einer Tabelle.

Verfügbare netsh mbn delete-Befehle:

dmprofile

Löscht ein DM-Konfigurationsprofil aus dem Profildatenspeicher.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
name Name der Profil-XML-Datei. Der Name der XML-Datei, die die Profildaten enthält. Erforderlich

Beispiel

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

Profil

Löscht ein Netzwerkprofil aus dem Profildatenspeicher.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
name Name der Profil-XML-Datei. Der Name der XML-Datei, die die Profildaten enthält. Erforderlich

Beispiel

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

diagnose

Führt Diagnosen für grundlegende Mobilfunkprobleme aus.

Syntax

diagnose [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

diagnose interface="Cellular"

Trennen der Verbindung

Trennt eine Verbindung mit einem mobilen Breitbandnetzwerk.

Syntax

disconnect [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

disconnect interface="Cellular"

dump

Zeigt ein Konfigurationsskript an.

Erstellt ein Skript, das die aktuelle Konfiguration enthält. Wird dieses Skript in einer Datei gespeichert, kann es verwendet werden, um geänderte Konfigurationseinstellungen wiederherzustellen.

Syntax

dump

Hilfe

Zeigt eine Liste mit Befehlen an.

Syntax

help

set

Legt Konfigurationsinformationen fest.

Die verfügbaren „netsh mbn set“-Befehle sind:

acstate

Legt den automatischen Verbindungsstatus für mobile Breitbanddaten für die angegebene Schnittstelle fest.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
name Der festzulegende automatische Verbindungsstatus. Einer der folgenden Werte:
autooff: Automatisches Verbindungstoken aus
autoon: Automatisches Verbindungstoken ein
manualoff: Manuelles Verbindungstoken aus
manualon: Manuelles Verbindungstoken ein
Erforderlich

Beispiel

set acstate interface="Cellular" state=autoon

dataenablement

Schaltet die mobilen Breitbanddaten für den angegebenen Profilsatz und die angegebene Schnittstelle ein bzw. aus.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
profileset Name des Profilsatzes. Erforderlich
mode Einer der folgenden Werte:
yes: Aktiviert den Zielprofilsatz.
no: Deaktiviert den Zielprofilsatz.
Erforderlich

Beispiel

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

dataroamcontrol

Legt den Roamingsteuerelement-Status für mobile Breitbanddaten für den angegebenen Profilsatz und die angegebene Schnittstelle fest.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
profileset Name des Profilsatzes. Erforderlich
mode Einer der folgenden Werte:
none: Nur Heimnetzbetreiber
partner: Nur Heim- und Partnernetzbetreiber
all: Heim-, Partner- und Roamingnetzbetreiber
Erforderlich

Beispiel

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

enterpriseapnparams

Legt die enterpriseAPN-Parameter für mobile Breitbanddaten für die angegebene Schnittstelle fest.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
allowusercontrol Einer der folgenden Werte:
yes: enterpriseAPN für das Benutzersteuerelement zulassen
no: enterpriseAPN für das Benutzersteuerelement nicht zulassen
nc: keine Änderung
Erforderlich
allowuserview Einer der folgenden Werte:
yes: enterpriseAPN für die Benutzeransicht zulassen
no: enterpriseAPN für die Benutzeransicht nicht zulassen
nc: keine Änderung
Erforderlich
profileaction Einer der folgenden Werte:
add: Ein enterpriseAPN-Profil wird hinzugefügt.
delete: Ein enterpriseAPN-Profil wird gelöscht.
modify: Ein enterpriseAPN-Profil wird geändert.
nc: keine Änderung
Erforderlich

Beispiel

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

highestconncategory

Legt die höchste Verbindungskategorie für mobile Breitbanddaten für die angegebene Schnittstelle fest.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
highestcc Einer der folgenden Werte:
admin: vom Administrator/von der Administratorin bereitgestellte Profile
user: vom Benutzer/von der Benutzerin bereitgestellte Profile
operator: vom Operator bereitgestellte Profile
device: vom Gerät bereitgestellte Profile
Erforderlich

Beispiel

set highestconncategory interface="Cellular" highestcc=operator

powerstate

Schaltet den mobilen Breitbandfunk für die angegebene Schnittstelle ein bzw. aus.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
state Einer der folgenden Werte:
on: Funkgerät einschalten
off: Funkgerät ausschalten
Erforderlich

Beispiel

set powerstate interface="Cellular" state=on

profileparameter

Legt Parameter in einem mobilen Breitbandnetzwerk-Profil fest.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
name Name des zu ändernden Profils. Wenn die Schnittstelle angegeben wird, wird nur das Profil auf dieser Schnittstelle geändert. Erforderlich
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Optional
cost Kosten im Zusammenhang mit dem Profil. Optional

Anmerkungen

Mindestens ein Parameter zwischen dem Schnittstellennamen und den Kosten muss angegeben werden.

Beispiel

set profileparameter name="profile 1" cost=default

slotmapping

Legt die Modemsteckplatz-Zuordnung für mobiles Breitband für die angegebene Schnittstelle fest.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
slotindex Festzulegender Steckplatzindex. Erforderlich

Beispiel

set slotmapping interface="Cellular" slotindex=1

tracing

Ablaufverfolgung aktivieren oder deaktivieren.

Syntax

set tracing [mode=]yes|no

Parameter

Parameter BESCHREIBUNG Anforderung
mode Einer der folgenden Werte:
yes: Aktiviert die Ablaufverfolgung für mobiles Breitband.
no: Deaktiviert die Ablaufverfolgung für mobiles Breitband.
Erforderlich

Beispiel

set tracing mode=yes

show

Zeigt Informationen zum mobilen Breitbandnetzwerk an.

Die verfügbaren „netsh mbn show“-Befehle sind:

acstate

Zeigt den automatischen Verbindungsstatus für mobile Breitbanddaten für die angegebene Schnittstelle an.

Syntax

show acstate [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show acstate interface="Cellular"

capability

Zeigt Informationen zu den Schnittstellenfunktionen für die angegebene Schnittstelle an.

Syntax

show capability [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show capability interface="Cellular"

connection

Zeigt die aktuellen Verbindungsinformationen für die angegebene Schnittstelle an.

Syntax

show connection [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show connection interface="Cellular"

dataenablement

Zeigt den Aktivierungsstatus für mobile Breitbanddaten für die angegebene Schnittstelle an.

Syntax

show dataenablement [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show dataenablement interface="Cellular"

dataroamcontrol

Zeigt den Roamingsteuerelement-Status für mobile Breitbanddaten für die angegebene Schnittstelle an.

Syntax

show dataroamcontrol [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show dataroamcontrol interface="Cellular"

dmprofiles

Zeigt eine Liste der auf dem System konfigurierten DM-Konfigurationsprofile an.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
name Namen des anzuzeigenden Profils. Optional
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Optional

Anmerkungen

Zeigt die Profildaten an oder listet die Profile auf dem System auf.

Wird der Profilname angegeben, wird der Inhalt des Profils angezeigt. Andernfalls werden Profile für die Schnittstelle aufgelistet.

Wird der Schnittstellenname angegeben, wird nur das angegebene Profil auf der angegebenen Schnittstelle aufgelistet. Andernfalls wird das erste übereinstimmende Profil angezeigt.

Beispiel

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

enterpriseapnparams

Zeigt die enterpriseAPN-Parameter für mobile Breitbanddaten für die angegebene Schnittstelle an.

Syntax

show enterpriseapnparams [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show enterpriseapnparams interface="Cellular"

highestconncategory

Zeigt die höchste Verbindungskategorie für mobile Breitbanddaten für die angegebene Schnittstelle an.

Syntax

show highestconncategory [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show highestconncategory interface="Cellular"

homeprovider

Zeigt die Heimanbieterinformationen für die angegebene Schnittstelle an.

Syntax

show homeprovider [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show homeprovider interface="Cellular"

interfaces

Zeigt eine Liste der mobilen Breitbandschnittstellen auf dem System an. Für diesen Befehl gebt es keine Parameter.

Syntax

show interfaces

netlteattachinfo

Zeigt die LTE-Attach-Informationen für das mobile Breitband für die angegebene Schnittstelle an.

Syntax

show netlteattachinfo [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show netlteattachinfo interface="Cellular"

pin

Zeigt die PIN-Informationen für die angegebene Schnittstelle an.

Syntax

show pin [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show pin interface="Cellular"

pinlist

Zeigt die PIN-Listeninformationen für die angegebene Schnittstelle an.

Syntax

show pinlist [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show pinlist interface="Cellular"

preferredproviders

Zeigt die Liste der bevorzugten Anbieter für die angegebene Schnittstelle an.

Syntax

show preferredproviders [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show preferredproviders interface="Cellular"

profiles

Zeigt eine Liste der auf dem System konfigurierten Profile an.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
name Namen des anzuzeigenden Profils. Optional
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Optional
purpose Zweck Optional

Anmerkungen

Wird der Profilname angegeben, wird der Inhalt des Profils angezeigt. Andernfalls werden Profile für die Schnittstelle aufgelistet.

Wird der Schnittstellenname angegeben, wird nur das angegebene Profil auf der angegebenen Schnittstelle aufgelistet. Andernfalls wird das erste übereinstimmende Profil angezeigt.

Wird der Zweck angegeben, werden nur Profile mit der passenden Zweck-GUID angezeigt. Andernfalls werden die Profile nicht nach dem Zweck gefiltert. Die Zeichenfolge kann entweder eine GUID mit geschweiften Klammern oder eine der folgenden Zeichenfolgen sein: „internet“, „supl“, „mms“, „ims“ oder „allhost“.

Beispiel

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

Zeigt den Status eines mobilen Breitbandprofils für die angegebene Schnittstelle an.

Syntax

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

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich
name Name des Profils. Der Name des Profils, dessen Status angezeigt werden soll Erforderlich

Beispiel

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

provisionedcontexts

Zeigt die bereitgestellten Kontextinformationen für die angegebene Schnittstelle an.

Syntax

show provisionedcontexts [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show provisionedcontexts interface="Cellular"

purpose

Zeigt die Zweckgruppen-GUIDs an, die zum Filtern von Profilen auf dem Gerät verwendet werden können. Für diesen Befehl gebt es keine Parameter.

Syntax

show purpose

radio

Zeigt die Funkzustandsinformationen für die angegebene Schnittstelle an.

Syntax

show radio [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show radio interface="Cellular"

readyinfo

Zeigt die Informationen zur Bereitschaft für die angegebene Schnittstelle an.

Syntax

show readyinfo [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show readyinfo interface="Cellular"

signal

Zeigt die Signalinformationen für die angegebene Schnittstelle an.

Syntax

show signal [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show signal interface="Cellular"

slotmapping

Zeigt die Modemsteckplatz-Zuordnung für mobiles Breitband für die angegebene Schnittstelle an.

Syntax

show slotmapping [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show slotmapping interface="Cellular"

slotstatus

Zeigt den Modemsteckplatz-Status für mobiles Breitband für die angegebene Schnittstelle an.

Syntax

show slotstatus [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show slotstatus interface="Cellular"

smsconfig

Zeigt die SMS-Konfigurationsinformationen für die angegebene Schnittstelle an.

Syntax

show smsconfig [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show smsconfig interface="Cellular"

tracing

Zeigt an, ob die Ablaufverfolgung für mobiles Breitband aktiviert oder deaktiviert ist.

Syntax

show tracing

visibleproviders

Zeigt die Liste der sichtbaren Anbieter für die angegebene Schnittstelle an.

Syntax

show visibleproviders [interface=]<string>

Parameter

Parameter BESCHREIBUNG Anforderung
interface Schnittstellenname. Einer der vom Befehl netsh mbn show interfaces angezeigten Schnittstellennamen Erforderlich

Beispiel

show visibleproviders interface="Cellular"

test

Führt Tests für einen bestimmten Featurebereich aus, während Protokolle gesammelt werden.

Syntax

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

Parameter

Tag Wert Optional?
feature Ein Featurebereich aus den unterstützten Featurebereichen, die im folgenden Abschnitt mit Anmerkungen aufgeführt sind. Erforderlich
testpath Pfad mit den Testbinärdateien Optional, wenn HLK Server installiert ist
taefpath Pfad mit den TAEF-Binärdateien Optional, wenn HLK Server installiert ist
param Durch Trennzeichen getrennte Parameter, die für die Tests verwendet werden sollen Erforderlich für bestimmte Featurebereiche, optional für andere

Anmerkungen

Unterstützte Featurebereiche sind:

  • Konnektivität
  • power
  • radio
  • esim
  • sms
  • dssa
  • lte
  • bringup

Für einige Tests sind weitere Parameter erforderlich, die im Feld param bereitgestellt werden müssen. Im Anschluss sind die erforderlichen Parameter für die Features aufgeführt:

  • connectivity: AccessString, UserName (falls zutreffend), Password (falls zutreffend)
  • radio: AccessString, UserName (falls zutreffend), Password (falls zutreffend)
  • esim: ActivationCode
  • bringup: AccessString, UserName (falls zutreffend), Password (falls zutreffend)

Beispiele

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