DevDetail CSP
The DevDetail configuration service provider handles the management object that provides device-specific parameters to the OMA DM server. These device parameters can be queried by servers using OMA DM commands. They aren't sent from the client to the server automatically.
Note
This configuration service provider requires the ID_CAP_CSP_FOUNDATION and ID_CAP_DEVICE_MANAGEMENT_ADMIN capabilities to be accessed from a network configuration application.
For the DevDetail CSP, you can't use the Replace command unless the node already exists. The OMA Client Provisioning protocol isn't supported for this configuration service provider.
The following list shows the DevDetail configuration service provider nodes:
- ./DevDetail
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/DevTyp
Returns the device model name /SystemProductName as a string.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext
Subtree to hold vendor-specific parameters.
Description framework properties:
Property name | Property value |
---|---|
Format | node |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1703 [10.0.15063] and later |
./DevDetail/Ext/DeviceHardwareData
Added in Windows 10 version 1703. Returns a base64 encoded string of the hardware parameters of a device.
Note
This node contains a raw blob used to identify a device in the cloud. It's not meant to be human readable by design and you can't parse the content to get any meaningful hardware information.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft
Subtree to hold vendor-specific parameters.
Description framework properties:
Property name | Property value |
---|---|
Format | node |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/CommercializationOperator
Returns the name of the mobile operator if it exists; otherwise it returns 404.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/DeviceName
Contains the user-specified device name. Support for Replace operation for Windows 10 Mobile was added in Windows 10, version 1511. Replace operation isn't supported in the desktop or IoT Core. When you change the device name using this node, it triggers a dialog on the device asking the user to reboot. The new device name doesn't take effect until the device is restarted. If the user cancels the dialog, it will show again until a reboot occurs.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get, Replace |
Reboot Behavior | Automatic |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 2004 [10.0.19041] and later |
./DevDetail/Ext/Microsoft/DNSComputerName
This node specifies the DNS name for a device. This setting can be managed remotely. A couple of macros can be embedded within the value for dynamic substitution: %RAND:<# of digits>
% and %SERIAL%. Examples: (a) "Test%RAND:6%" will generate a name "Test" followed by 6 random digits (e.g., "Test123456"). (b) "Foo%SERIAL%", will generate a name "Foo" followed by the serial number derived from device's ID. If both macros are in the string, the RANDOM macro will take priority over the SERIAL macro (SERIAL will be ignored). The server must explicitly reboot the device for this value to take effect. This value has a maximum allowed length of 63 characters as per DNS standards.
This node replaces the Domain/ComputerName node in Accounts CSP.
Note
We recommend using %SERIAL%
or %RAND:x%
with a high character limit to reduce the chance of name collision when generating a random name. This feature doesn't check if a particular name is already present in the environment.
On desktop PCs, this setting specifies the DNS hostname of the computer (Computer Name) up to 63 characters. Use %RAND:x%
to generate x number of random digits in the name, where x must be a number less than 63. For domain-joined computers, the unique name must use %RAND:x%
. Use %SERIAL%
to generate the name with the computer's serial number embedded. If the serial number exceeds the character limit, it will be truncated from the beginning of the sequence. The character restriction limit doesn't count the length of the macros, %RAND:x%
and %SERIAL%
. This setting is supported only in Windows 10, version 1803 and later. To change this setting in Windows 10, version 1709 and earlier releases, use the ComputerName setting under Accounts > ComputerAccount.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get, Replace |
Reboot Behavior | ServerInitiated |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/FreeStorage
Total free storage in MB from first internal drive on the device.
Description framework properties:
Property name | Property value |
---|---|
Format | int |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/LocalTime
Returns the client local time in ISO 8601 format. Example: 2003-06-16. T18:37:44Z.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/MobileID
Returns the mobile device ID associated with the cellular network. Returns 404 for devices that don't have a cellular network support. The IMSI value is returned for GSM and UMTS networks. CDMA and worldwide phones will return a 404 Not Found status code error if queried for this element.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/OSPlatform
Returns the OS platform of the device. For Windows 10 for desktop editions, it returns the ProductName as defined in HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProductName.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/ProcessorArchitecture
Returns the processor architecture of the device as "arm" or "x86".
Description framework properties:
Property name | Property value |
---|---|
Format | int |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/ProcessorType
Returns the processor type of the device as documented in SYSTEM_INFO.
Description framework properties:
Property name | Property value |
---|---|
Format | int |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/RadioSwV
Returns the radio stack software version number.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/Resolution
Resolution of the device in the format of WidthxLength (e.g., "400x800").
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1809 [10.0.17763] and later |
./DevDetail/Ext/Microsoft/SMBIOSSerialNumber
SMBIOS Serial Number of the device.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 2004 with KB5007253 [10.0.19041.1387] and later ✅ Windows 10, version 20H2 with KB5007253 [10.0.19042.1387] and later ✅ Windows 10, version 21H1 with KB5007253 [10.0.19043.1387] and later ✅ Windows 10, version 21H2 with KB5007253 [10.0.19044.1387] and later ✅ Windows 11, version 21H2 [10.0.22000] and later |
./DevDetail/Ext/Microsoft/SMBIOSVersion
SMBIOS version of the device.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/SystemSKU
Returns the System SKU, as defined in the registry key HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\BIOS\SystemSKU.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/TotalRAM
Total available memory in MB on the device (may be less than total physical memory).
Description framework properties:
Property name | Property value |
---|---|
Format | int |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/Microsoft/TotalStorage
Total available storage in MB from first internal drive on the device (may be less than total physical storage). Available for Windows Mobile only.
Description framework properties:
Property name | Property value |
---|---|
Format | int |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/VoLTEServiceSetting
The VoLTE service setting on or off. Only exposed to Mobile Operator-based OMA-DM servers.
Description framework properties:
Property name | Property value |
---|---|
Format | bool |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/WlanDnsSuffix
The DNS suffix of the active WiFi connection. Only exposed to Enterprise-based OMA-DM servers.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/WlanIPv4Address
The IPv4 address of the active WiFi connection. Only exposed to Enterprise-based OMA-DM servers.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/WlanIPv6Address
The IPv6 address of the active WiFi connection. Only exposed to Enterprise-based OMA-DM servers.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/WLANMACAddress
The MAC address of the active WiFi connection.
Note
This isn't supported in Windows 10 for desktop editions.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/Ext/WlanSubnetMask
The subnet mask for the active WiFi connection. Only exposed to Enterprise-based OMA-DM servers.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/FwV
Returns the firmware version, as defined in the registry key HKEY_LOCAL_MACHINE\System\Platform\DeviceTargetingInfo\PhoneFirmwareRevision. For Windows 10 for desktop editions (Home, Pro, Enterprise, and Education), it returns the BIOS version as defined in the registry key HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\BIOS\BIOSVersion.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/HwV
Returns the hardware version, as defined in the registry key HKEY_LOCAL_MACHINE\System\Platform\DeviceTargetingInfo\PhoneRadioHardwareRevision. For Windows 10 for desktop editions, it returns the BIOS version as defined in the registry key HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\BIOS\BIOSVersion.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/LrgObj
Returns whether the device uses OMA DM Large Object Handling, as defined in the specification SyncML Device Information, version 1.1.2.
Description framework properties:
Property name | Property value |
---|---|
Format | bool |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/OEM
Returns the name of the Original Equipment Manufacturer (OEM) as a string, as defined in the specification SyncML Device Information, version 1.1.2.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/SwV
Returns the Windows 10 OS software version in the format MajorVersion. MinorVersion. BuildNumber. QFEnumber. Currently the BuildNumber returns the build number on the desktop and mobile build number on the phone. In the future, the build numbers may converge.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/URI
Description framework properties:
Property name | Property value |
---|---|
Format | node |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/URI/MaxDepth
Returns the maximum depth of the management tree that the device supports. The default is zero (0). This is the maximum number of URI segments that the device supports. The default value zero (0) indicates that the device supports a URI of unlimited depth.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/URI/MaxSegLen
Returns the total length of any URI segment in a URI that addresses a node or node property. The default is zero (0). This is the largest number of characters that the device can support in a single URI segment. The default value zero (0) indicates that the device supports URI segment of unlimited length.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |
Scope | Editions | Applicable OS |
---|---|---|
✅ Device ❌ User |
✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC |
✅ Windows 10, version 1511 [10.0.10586] and later |
./DevDetail/URI/MaxTotLen
Returns the maximum total length of any URI used to address a node or node property. The default is zero (0). This is the largest number of characters in the URI that the device supports. The default value zero (0) indicates that the device supports a URI of unlimited length.
Description framework properties:
Property name | Property value |
---|---|
Format | chr (string) |
Access Type | Get |