Table of contents
TOC
Collapse the table of content
Expand the table of content

EnterpriseExt CSP

Last Updated: 10/28/2016

The EnterpriseExt configuration service provider allows OEMs to set their own unique ID for their devices, set display brightness values, and set the LED behavior.

Note The EnterpriseExt CSP is only supported in Windows 10 Mobile.

The following diagram shows the EnterpriseExt configuration service provider in tree format as used by both the Open Mobile Alliance (OMA) Device Management (DM) and OMA Client Provisioning.

enterpriseext csp

The following list shows the characteristics and parameters.

./Vendor/MSFT/EnterpriseExt
The root node for the EnterpriseExt configuration service provider. Supported operations is Get.

DeviceCustomData
Node for setting the custom device ID and string.

DeviceCustomData/CustomID
Any string value as the device ID. This value appears in Settings > About > Info.

Here's an example for getting custom data.

<?xml version="1.0"?>
<SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
        <Get>
            <CmdID>1</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/EnterpriseExt/DeviceCustomData/CustomID</LocURI>
                </Target>
            </Item>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/EnterpriseExt/DeviceCustomData/CustomString</LocURI>
                </Target>
            </Item>
        </Get>
        <Final/>
    </SyncBody>
</SyncML>

DeviceCustomData/CustomString
Any string value that is associated with the device.

Here's an example for setting custom data.

<?xml version="1.0"?>
<SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
        <Replace>
            <CmdID>1</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/EnterpriseExt/DeviceCustomData/CustomID</LocURI>
                </Target>
                <Data>urn:uuid:130CCE0D-0187-5866-855A-DE7406F76046</Data> 
            </Item>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/EnterpriseExt/DeviceCustomData/CustomString</LocURI>
                </Target>
                <Data>{"firstName":"John","lastName":"Doe"}</Data> 
            </Item>
        </Replace>
        <Final/>
    </SyncBody>
</SyncML>

Brightness
Node for setting device brightness values.

Brightness/Default
Default display brightness value. For example, you can maximize battery life by reducing the default value or set it to medium in a facility that is generally darker.

The valid values are:

  • Automatic - the device determines the brightness
  • Low
  • Medium
  • High

The supported operations are Get and Replace.

Here's an example for getting the current default value.

<?xml version="1.0"?>
<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Get>
      <CmdID>2</CmdID>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/EnterpriseExt/Brightness/Default</LocURI>
        </Target>
      </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

Here's an example for setting the default value to medium.

<?xml version="1.0"?>
<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Replace>
      <CmdID>2</CmdID>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/EnterpriseExt/Brightness/Default</LocURI>
        </Target>
        <Data>medium</Data>
      </Item>
    </Replace>
    <Final/>
  </SyncBody>
</SyncML>

Brightness/MaxAuto
Maximum display brightness value when the device is set to automatic mode. The device brightness will never be higher than the MaxAuto value. The value values are:

  • Low
  • Medium
  • High

The supported operations are Get and Replace.

Here's an example for setting the maximum auto-brightness to medium.

<?xml version="1.0"?>
<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Replace>
      <CmdID>2</CmdID>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/EnterpriseExt/Brightness/MaxAuto</LocURI>
        </Target>
        <Data>medium</Data>
      </Item>
    </Replace>
    <Final/>
  </SyncBody>
</SyncML>

LedAlertNotification
Node for setting LED behavior of the device.

LedAlertNotification/State
LED state. The valid values are:

  • 0 - off
  • 1 - on
  • 2 - blink

Example: LED On

<?xml version="1.0"?>
<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Replace>
      <CmdID>3</CmdID>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/EnterpriseExt/LedAlertNotification/Intensity</LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">int</Format>
        </Meta>        
        <Data>100</Data>
      </Item>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/EnterpriseExt/LedAlertNotification/State</LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">int</Format>
        </Meta>        
        <Data>1</Data>
      </Item>
    </Replace>
    <Final/>
  </SyncBody>
</SyncML>

Example: LED Off

<?xml version="1.0"?>
<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Replace>
      <CmdID>3</CmdID>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/EnterpriseExt/LedAlertNotification/State</LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">int</Format>
        </Meta>        
        <Data>0</Data>
      </Item>
    </Replace>
    <Final/>
  </SyncBody>
</SyncML>

LedAlertNotification/Intensity
Intensity of the LED brightness. You can set the value between 1 - 100.

Example: LED blink

<?xml version="1.0"?>
<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Replace>
      <CmdID>3</CmdID>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/EnterpriseExt/LedAlertNotification/Period</LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">int</Format>
        </Meta>        
        <Data>500</Data>
      </Item>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/EnterpriseExt/LedAlertNotification/Dutycycle</LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">int</Format>
        </Meta>        
        <Data>70</Data>
      </Item>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/EnterpriseExt/LedAlertNotification/Intensity</LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">int</Format>
        </Meta>        
        <Data>100</Data>
      </Item>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/EnterpriseExt/LedAlertNotification/Cyclecount</LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">int</Format>
        </Meta>        
        <Data>543210</Data>
      </Item>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/EnterpriseExt/LedAlertNotification/State</LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">int</Format>
        </Meta>        
        <Data>2</Data>
      </Item>
    </Replace>
    <Final/>
  </SyncBody>
</SyncML>

LedAlertNotification/Period
Duration of each blink, which is the time of ON + OFF. The value is in milliseconds. This is valid only for blink.

LedAlertNotification/DutyCycle
LED ON duration during one blink cycle. You can set the value between 1 - 100. This is valid only for blink.

LedAlertNotification/Cyclecount
Number of blink cycles. The data type is a 4-byte signed integer. Any negative value or zero results in an error. This node is only valid for blink.

DeviceReboot
Removed in Windows 10.

DeviceReboot/WaitTime
Removed in Windows 10.

MaintenanceWindow
Removed in Windows 10.

MaintenanceWindow/MaintenanceAllowed
Removed in Windows 10.

MaintenanceWindow/MWMandatory
Removed in Windows 10.

MaintenanceWindow/ScheduleXML
Removed in Windows 10.

MaintenanceWindow/MWNotificationDuration
Removed in Windows 10.

MaintenanceWindow/MWminimumDuration
Removed in Windows 10.

DeviceUpdate
Removed in Windows 10.

DeviceUpdate/DateTimeStamp
Removed in Windows 10.

DeviceUpdate/UpdateResultXml
Removed in Windows 10.

MDM
Removed in Windows 10.

MDM/Server
Removed in Windows 10.

MDM/Username
Removed in Windows 10.

MDM/Password
Removed in Windows 10.

MDM/EnableDeviceEnrollment
Removed in Windows 10.

Pfx
Removed in Windows 10.

DisableEnterpriseValidation
Removed in Windows 10.

10/10/2016

© 2017 Microsoft