Bewerken

Delen via


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:

DevTyp

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

Ext

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

Ext/DeviceHardwareData

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

Ext/Microsoft

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

Ext/Microsoft/CommercializationOperator

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

Ext/Microsoft/DeviceName

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

Ext/Microsoft/DNSComputerName

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

Ext/Microsoft/FreeStorage

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

Ext/Microsoft/LocalTime

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

Ext/Microsoft/MobileID

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

Ext/Microsoft/OSPlatform

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

Ext/Microsoft/ProcessorArchitecture

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

Ext/Microsoft/ProcessorType

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

Ext/Microsoft/RadioSwV

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

Ext/Microsoft/Resolution

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

Ext/Microsoft/SMBIOSSerialNumber

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

Ext/Microsoft/SMBIOSVersion

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

Ext/Microsoft/SystemSKU

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

Ext/Microsoft/TotalRAM

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

Ext/Microsoft/TotalStorage

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

Ext/VoLTEServiceSetting

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

Ext/WlanDnsSuffix

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

Ext/WlanIPv4Address

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

Ext/WlanIPv6Address

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

Ext/WLANMACAddress

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

Ext/WlanSubnetMask

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

FwV

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

HwV

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

LrgObj

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

OEM

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

SwV

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

URI

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

URI/MaxDepth

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

URI/MaxSegLen

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

URI/MaxTotLen

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

Configuration service provider reference