MBNProfileExt

Article
08/26/2021

The MBNProfileExt element is an extension of the earlier MBNProfile element. It identifies a Mobile Broadband profile with a richer set of options than the MBNProfile element.

There can be more than one MbnProfileExt element in a profile, describing profile settings for a particular set of operating conditions. Use the ProfileConditionedOn child element of MBNProfileExt to specify which operating conditions make a particular profile the active profile.

Element hierarchy

<MBNProfileExt>

Syntax

<MBNProfileExt>

  <!-- Child elements -->
  Name,
  Description?,
  ICONFilePath?,
  IsDefault,
  ProfileCreationType?,
  SubscriberID?,
  SimIccID,
  HomeProviderName?,
  AutoConnectOnInternet?,
  ConnectionMode?,
  Context?,
  DataRoamingPartners?,
  PurposeGroups?,
  ProfileConditionedOn?,
  IsProvisioningProfile?,
  ApnID?,
  AdminEnable?,
  AdminRoamControl?,
  IsExclusiveToOther?,
  IsLongStandingAdditionalPdpContextProfile?,
  MmsConfiguration?,
  any element in a non-schema namespace*

</MBNProfileExt>

Key

? optional (zero or one)

* optional (zero or more)

Attributes and Elements

Attributes

None.

Child Elements

Child Element	Description
AdminEnable	Specifies whether the profile is enabled administratively.This is a new element for v4.
AdminRoamControl	Specifies whether the profile is administratively roam controlled. This element is new for v4. The value of this element is a roamControlType value. This is an optional element; if no value is specified, then AllRoamAllowed is the default.
ApnID	An APN ID associated with this profile.This element is new in v4, and it is optional.
AutoConnectOnInternet	Specifies whether the Mobile Broadband device will automatically connect to a network. For more information, see the documentation for the v1 AutoConnectOnInternet element.
ConnectionMode	Specifies the auto connection setting to be used for a Mobile Broadband device. For more information, see the documentation for the v1 ConnectionMode element.
Context	Specifies the parameters required to establish a data connection.
DataRoamingPartners	Specifies a list of preferred network providers when roaming. For details, see the documentation for the v1 DataRoamingPartners element.
Description	A description of the profile.
HomeProviderName	The name of the home provider for the given SIM/Device. For more information, see the documentation for the v1 HomeProviderName element.
ICONFilePath	The path to the icon file for the connection. The operating system connection user interface displays the icon when a connection is made using this profile. For more details on using this element, see the v1 documentation for ICONFilePath.
IsDefault	Specifies whether this profile is the default profile. For more detail on this element, see the v1 documentation for IsDefault.
IsExclusiveToOther	Specifies that this profile is exclusive to other profiles of the same profile set(s).This element is new for v4.
IsLongStandingAdditionalPdpContextProfile	Specifies that this profile is a long-standing additional PDP context profile.If the value of this element is true, then IsAdditionalPdpContextProfile must also be set to true. This is a new element for v4.
IsProvisioningProfile	Specifies that this profile is to be used for provisioning only.Otherwise, the profile is not applicable, and cannot be used to activate a Packet Data Protocol (PDP) context. This element is new for v4. If IsProvisioningProfile is true, IsDefault must be false, and ConnectionMode must be manual.
MmsConfiguration	Configuration information for Multimedia Messaging Service (MMS). In addition to setting the configuration elements within this element, an MMS profile must have the following settings. Its Name element must contain a system-wide unique name. Its ProfileCreationType must be set to UserProvisioned. Its SimIccID must contain the ICCID of the SIM that this profile is intended for. Its ConnectionMode must be set to Manual. Its PurposeGroupGuid must contain the GUID for MMS purpose group. Its IsAdditionalPdpContextProfile must be set to true.
Name	The name of the profile. For more information, see the documentation for the v1 Name element.
ProfileConditionedOn	Specifies the conditions which must be satisfied for a profile to be applicable. This element is new for v4. It enables you to specify multiple profiles that apply in different conditions, and for the proper profile to be used automatically when it is applicable. This element is optional. If you do not specify it, then the profile is always applicable with respect to the conditions listed.
ProfileCreationType (in MBNProfileExt)	Specifies the creator of the profile. For more information about this element, see the documentation for the v1 ProfileCreationType element.
PurposeGroups	An optional list of groups of profiles, where each group includes profiles used for a common purpose. This element is new for v4 of the schema. One profile can be listed in multiple groups.
SimIccID	The SIM Identifcation number for GSM devices. For more details , see the documentation for the v1 SimIccID element.
SubscriberID	Identifies the unique identifier of the profile. For a GSM network this should contain the IMSI (International Mobile Subscriber Identity) of the SIM and for CDMA devices it should contain the MIN (Mobile Identification Number) of the device. For more information, see the documentation for the v1 SubscriberID element.

Parent Elements

This outermost (document) element may not be contained by any other elements.

Requirements

Requirement	Value
Namespace	https://www.microsoft.com/networking/WWAN/profile/v4

Share via