deepblue/windows-itpro-docs
1
0
Fork 0
mirror of https://github.com/MicrosoftDocs/windows-itpro-docs.git synced 2025-05-12 13:27:23 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

DevDetail CSP

Browse Source
This commit is contained in:
Vinay Pamnani 2023-02-17 16:07:38 -05:00
parent 43dbde8a64
commit 2af970dae6
2 changed files with 1536 additions and 217 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1515
windows/client-management/mdm/devdetail-csp.md
View File

File diff suppressed because it is too large Load Diff

238
windows/client-management/mdm/devdetail-ddf-file.md
View File

@ -1,31 +1,29 @@
---
title: DevDetail DDF file
description: Learn about the OMA DM device description framework (DDF) for the DevDetail configuration service provider.
ms.reviewer:
description: View the XML file containing the device description framework (DDF) for the DevDetail configuration service provider.
author: vinaypamnani-msft
manager: aaroncz
ms.author: vinpa
ms.topic: article
ms.date: 02/17/2023
ms.localizationpriority: medium
ms.prod: windows-client
ms.technology: itpro-manage
author: vinaypamnani-msft
ms.date: 06/03/2020
ms.topic: reference
---
<!-- Auto-Generated CSP Document -->
# DevDetail DDF file
This topic shows the OMA DM device description framework (DDF) for the **DevDetail** configuration service provider. DDF files are used only with OMA DM provisioning XML.
Looking for the DDF XML files? See [CSP DDF files download](configuration-service-provider-ddf.md).
The XML below is the current version for this CSP.
The following XML file contains the device description framework (DDF) for the DevDetail configuration service provider.
```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE MgmtTree PUBLIC "-//OMA//DTD-DM-DDF 1.2//EN"
"http://www.openmobilealliance.org/tech/DTD/DM_DDF-V1_2.dtd"
[<?oma-dm-ddf-ver supported-versions="1.2"?>]>
<!DOCTYPE MgmtTree PUBLIC " -//OMA//DTD-DM-DDF 1.2//EN" "http://www.openmobilealliance.org/tech/DTD/DM_DDF-V1_2.dtd"[<?oma-dm-ddf-ver supported-versions="1.2"?>]>
<MgmtTree xmlns:MSFT="http://schemas.microsoft.com/MobileDevice/DM">
<VerDTD>1.2</VerDTD>
<MSFT:Diagnostics>
</MSFT:Diagnostics>
<Node>
<NodeName>DevDetail</NodeName>
<Path>.</Path>
@ -33,6 +31,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>The DevDetail configuration service provider handles the management object which provides device-specific parameters to the OMA DM server.</Description>
<DFFormat>
<node />
</DFFormat>
@ -43,8 +42,13 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<DDFName>urn:oma:mo:oma-dm-devdetail:1.2</DDFName>
<MIME />
</DFType>
<MSFT:Applicability>
<MSFT:OsBuildVersion>10.0.10586</MSFT:OsBuildVersion>
<MSFT:CspVersion>1.0</MSFT:CspVersion>
<MSFT:EditionAllowList>0x4;0x1B;0x30;0x31;0x48;0x54;0x62;0x63;0x64;0x65;0x77;0x79;0x7A;0x7D;0x7E;0x81;0x82;0x87;0x88;0x88*;0x8A;0x8B;0xA1;0xA2;0xA4;0xA5;0xAB;0xAC;0xAF;0xB4;0xBC;0xBF;0xCA;0xCB;0xCD;</MSFT:EditionAllowList>
</MSFT:Applicability>
</DFProperties>
<Node>
<NodeName>URI</NodeName>
@ -62,7 +66,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
<DDFName />
</DFType>
</DFProperties>
<Node>
@ -71,6 +75,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>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>
<DFFormat>
<chr />
</DFFormat>
@ -81,7 +86,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -91,6 +96,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>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>
<DFFormat>
<chr />
</DFFormat>
@ -101,7 +107,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -111,6 +117,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>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>
<DFFormat>
<chr />
</DFFormat>
@ -121,7 +128,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -132,7 +139,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>Device model name, as specified and tracked by the manufacturer</Description>
<Description>Returns the device model name /SystemProductName as a string.</Description>
<DFFormat>
<chr />
</DFFormat>
@ -143,7 +150,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -153,7 +160,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>Name of OEM</Description>
<Description>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>
<DFFormat>
<chr />
</DFFormat>
@ -164,7 +171,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -174,7 +181,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>Provide the version of OEM ROM region.</Description>
<Description>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>
<DFFormat>
<chr />
</DFFormat>
@ -185,7 +192,28 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
<Node>
<NodeName>SwV</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>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>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -195,7 +223,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>Returns the hardware version.</Description>
<Description>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>
<DFFormat>
<chr />
</DFFormat>
@ -206,7 +234,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -216,9 +244,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>
Large object isn't supported. The data for this node is "false".
</Description>
<Description>Returns whether the device uses OMA DM Large Object Handling, as defined in the specification SyncML Device Information, version 1.1.2.</Description>
<DFFormat>
<bool />
</DFFormat>
@ -229,7 +255,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -250,7 +276,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
<DDFName />
</DFType>
</DFProperties>
<Node>
@ -270,7 +296,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
<DDFName />
</DFType>
</DFProperties>
<Node>
@ -279,7 +305,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>Indicates the subscriber ID registered with the cellular network. For GSM and UMTS networks, the value returned is the IMSI value; for other networks, SyncML Status code 404 is returned.</Description>
<Description>Returns the mobile device ID associated with the cellular network. Returns 404 for devices that do not 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>
<DFFormat>
<chr />
</DFFormat>
@ -290,7 +316,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -300,7 +326,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>Version of the software radio stack</Description>
<Description>Returns the radio stack software version number.</Description>
<DFFormat>
<chr />
</DFFormat>
@ -311,7 +337,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -332,7 +358,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -342,7 +368,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>Name of operator with whom the device was commercialized.</Description>
<Description>Returns the name of the mobile operator if it exists; otherwise it returns 404.</Description>
<DFFormat>
<chr />
</DFFormat>
@ -353,7 +379,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -363,7 +389,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>Processor architecture of the device, as returned by the GetSystemInfo API.</Description>
<Description>Returns the processor architecture of the device as "arm" or "x86".</Description>
<DFFormat>
<int />
</DFFormat>
@ -374,7 +400,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -384,7 +410,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>Processor type of the device, as returned by the GetSystemInfo API.</Description>
<Description>Returns the processor type of the device as documented in SYSTEM_INFO.</Description>
<DFFormat>
<int />
</DFFormat>
@ -395,7 +421,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -405,7 +431,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>Name of the operating system platform.</Description>
<Description>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>
<DFFormat>
<chr />
</DFFormat>
@ -416,7 +442,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -426,7 +452,7 @@ The XML below is the current version for this CSP.
<AccessType>
<Get />
</AccessType>
<Description>Returns the UTC time formatted per ISO8601. Example: 2003-06-16T18:37:44Z.</Description>
<Description>Returns the client local time in ISO 8601 format. Example: 2003-06-16T18:37:44Z.</Description>
<DFFormat>
<chr />
</DFFormat>
@ -437,7 +463,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -448,7 +474,7 @@ The XML below is the current version for this CSP.
<Get />
<Replace />
</AccessType>
<Description>User-specified device name</Description>
<Description>Contains the user-specified device name. Support for Replace operation for Windows 10 Mobile was added in Windows 10, version 1511. Replace operation is not 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 does not take effect until the device is restarted. If the user cancels the dialog, it will show again until a reboot occurs.</Description>
<DFFormat>
<chr />
</DFFormat>
@ -459,8 +485,11 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
<MSFT:AllowedValues ValueType="None">
</MSFT:AllowedValues>
<MSFT:RebootBehavior>Automatic</MSFT:RebootBehavior>
</DFProperties>
</Node>
<Node>
@ -470,7 +499,7 @@ The XML below is the current version for this CSP.
<Get />
<Replace />
</AccessType>
<Description>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:&lt;# of digits&gt;% 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.</Description>
<Description><![CDATA[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.]]></Description>
<DFFormat>
<chr />
</DFFormat>
@ -481,8 +510,15 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
<MSFT:Applicability>
<MSFT:OsBuildVersion>10.0.19041</MSFT:OsBuildVersion>
<MSFT:CspVersion>1.2</MSFT:CspVersion>
</MSFT:Applicability>
<MSFT:AllowedValues ValueType="None">
</MSFT:AllowedValues>
<MSFT:RebootBehavior>ServerInitiated</MSFT:RebootBehavior>
</DFProperties>
</Node>
<Node>
@ -502,7 +538,28 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
<Node>
<NodeName>FreeStorage</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>Total free storage in MB from first internal drive on the device.</Description>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -523,7 +580,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -544,7 +601,57 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
<MSFT:Applicability>
<MSFT:OsBuildVersion>10.0.17763</MSFT:OsBuildVersion>
<MSFT:CspVersion>1.2</MSFT:CspVersion>
</MSFT:Applicability>
</DFProperties>
</Node>
<Node>
<NodeName>SMBIOSVersion</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>SMBIOS version of the device.</Description>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME />
</DFType>
<MSFT:Applicability>
<MSFT:OsBuildVersion>10.0.22000, 10.0.19041.1387, 10.0.19042.1387, 10.0.19043.1387, 10.0.19044.1387</MSFT:OsBuildVersion>
<MSFT:CspVersion>1.2</MSFT:CspVersion>
</MSFT:Applicability>
</DFProperties>
</Node>
<Node>
<NodeName>SystemSKU</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>Returns the System SKU, as defined in the registry key HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\BIOS\SystemSKU.</Description>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -566,7 +673,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -587,7 +694,7 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -608,7 +715,7 @@ The XML below is the current version for this CSP.
<Dynamic />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -629,7 +736,7 @@ The XML below is the current version for this CSP.
<Dynamic />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -650,7 +757,7 @@ The XML below is the current version for this CSP.
<Dynamic />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -671,7 +778,7 @@ The XML below is the current version for this CSP.
<Dynamic />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
</DFProperties>
</Node>
@ -692,12 +799,19 @@ The XML below is the current version for this CSP.
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
<MIME />
</DFType>
<MSFT:Applicability>
<MSFT:OsBuildVersion>10.0.15063</MSFT:OsBuildVersion>
<MSFT:CspVersion>1.1</MSFT:CspVersion>
</MSFT:Applicability>
</DFProperties>
</Node>
</Node>
</Node>
</MgmtTree>
```
## Related articles
[DevDetail configuration service provider reference](devdetail-csp.md)