From 43dbde8a64a45d324f2bfdc1cd0edb587329ab54 Mon Sep 17 00:00:00 2001
From: Vinay Pamnani <37223378+vinaypamnani-msft@users.noreply.github.com>
Date: Fri, 17 Feb 2023 15:55:00 -0500
Subject: [PATCH] DevInfo CSP
---
windows/client-management/mdm/devinfo-csp.md | 341 ++++++++++++++---
.../client-management/mdm/devinfo-ddf-file.md | 344 ++++++++++--------
2 files changed, 481 insertions(+), 204 deletions(-)
diff --git a/windows/client-management/mdm/devinfo-csp.md b/windows/client-management/mdm/devinfo-csp.md
index eeef8c18ab..09557a63e0 100644
--- a/windows/client-management/mdm/devinfo-csp.md
+++ b/windows/client-management/mdm/devinfo-csp.md
@@ -1,84 +1,331 @@
---
title: DevInfo CSP
-description: Learn how the DevInfo configuration service provider handles the managed object that provides device information to the OMA DM server.
-ms.reviewer:
+description: Learn more about the DevInfo CSP.
+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/26/2017
+ms.topic: reference
---
+
+
+
# DevInfo CSP
-The table below shows the applicability of Windows:
-
-|Edition|Windows 10|Windows 11|
-|--- |--- |--- |
-|Home|Yes|Yes|
-|Pro|Yes|Yes|
-|Windows SE|No|Yes|
-|Business|Yes|Yes|
-|Enterprise|Yes|Yes|
-|Education|Yes|Yes|
-
+
+
The DevInfo configuration service provider handles the managed object, which provides device information to the OMA DM server. This device information is automatically sent to the OMA DM server at the beginning of each OMA DM session.
> [!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 DevInfo CSP, you can't use the Replace command unless the node already exists.
+For the DevInfo CSP, you can't use the Replace command unless the node already exists. The OMA Client provisioning protocol isn't supported by this configuration service provider.
+
-The following shows the DevInfo configuration service provider management object in tree format as used by OMA Device Management. The OMA Client provisioning protocol isn't supported by this configuration service provider.
+
+The following example shows the DevInfo configuration service provider in tree format.
+```text
+./DevInfo
+--- DevId
+--- DmV
+--- Ext
+------ ICCID
+--- Lang
+--- Man
+--- Mod
```
-.
-DevInfo
-----DevId
-----Man
-----Mod
-----DmV
-----Lang
+
+
+
+## DevId
+
+
+| Scope | Editions | Applicable OS |
+|:--|:--|:--|
+| :heavy_check_mark: Device
:x: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later |
+
+
+
+```Device
+./DevInfo/DevId
```
+
-**DevId**
-Required. Returns an application-specific global unique device identifier by default.
+
+
+An unique device identifier. An application-specific global unique device identifier is provided in this node.
+
-Supported operation is Get.
-
-The **UseHWDevID** parm of the [DMAcc configuration service provider](dmacc-csp.md) or DMS configuration service provider can be used to modify the return value to instead return a hardware device ID as follows:
+
+
+**UseHWDevID** node of the [DMAcc configuration service provider](dmacc-csp.md) can be used to modify the return value to instead return a hardware device ID as follows:
- For GSM phones, the IMEI is returned.
- For CDMA phones, the MEID is returned.
- For dual SIM phones, this value is retrieved from the UICC of the primary data line.
-- For Windows 10 for desktop editions (Home, Pro, Enterprise, and Education), it returns an application specific global unique identifier (GUID) irrespective of the value of UseHWDevID.
+- For Windows 10 for desktop editions (Home, Pro, Enterprise, and Education), an application specific global unique identifier (GUID) is returned irrespective of the value of UseHWDevID.
+
-**Man**
-Required. Returns the name of the OEM. For Windows 10 for desktop editions, it returns the SystemManufacturer as defined in HKEY\_LOCAL\_MACHINE\\HARDWARE\\DESCRIPTION\\System\\BIOS\\SystemManufacturer.
+
+**Description framework properties**:
-If no name is found, this returns to "Unknown".
+| Property name | Property value |
+|:--|:--|
+| Format | chr (string) |
+| Access Type | Get |
+
-Supported operation is Get.
+
+
+
-**Mod**
-Required. Returns the name of the hardware device model as specified by the mobile operator. For Windows 10/Windows 11 desktop editions, it returns the SystemProductName as defined in HKEY\_LOCAL\_MACHINE\\HARDWARE\\DESCRIPTION\\System\\BIOS\\SystemProductName.
+
-If no name is found, this returns to "Unknown".
+
+## DmV
-Supported operation is Get.
+
+| Scope | Editions | Applicable OS |
+|:--|:--|:--|
+| :heavy_check_mark: Device
:x: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later |
+
-**DmV**
-Required. Returns the current management client revision of the device.
+
+```Device
+./DevInfo/DmV
+```
+
-Supported operation is Get.
+
+
+The current management client revision of the device.
+
-**Lang**
-Required. Returns the current user interface (UI) language setting of the device as defined by RFC1766.
+
+
+
-Supported operation is Get.
+
+**Description framework properties**:
-## Related topics
+| Property name | Property value |
+|:--|:--|
+| Format | chr (string) |
+| Access Type | Get |
+
-[Configuration service provider reference](index.yml)
+
+
+
+
+
+
+
+## Ext
+
+
+| Scope | Editions | Applicable OS |
+|:--|:--|:--|
+| :heavy_check_mark: Device
:x: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later |
+
+
+
+```Device
+./DevInfo/Ext
+```
+
+
+
+
+Parent node for nodes extended by Microsoft.
+
+
+
+
+
+
+
+**Description framework properties**:
+
+| Property name | Property value |
+|:--|:--|
+| Format | node |
+| Access Type | Get |
+
+
+
+
+
+
+
+
+
+### Ext/ICCID
+
+
+| Scope | Editions | Applicable OS |
+|:--|:--|:--|
+| :heavy_check_mark: Device
:x: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later |
+
+
+
+```Device
+./DevInfo/Ext/ICCID
+```
+
+
+
+
+Retrieves the ICCID of the first adapter.
+
+
+
+
+
+
+
+**Description framework properties**:
+
+| Property name | Property value |
+|:--|:--|
+| Format | chr (string) |
+| Access Type | Get |
+
+
+
+
+
+
+
+
+
+## Lang
+
+
+| Scope | Editions | Applicable OS |
+|:--|:--|:--|
+| :heavy_check_mark: Device
:x: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later |
+
+
+
+```Device
+./DevInfo/Lang
+```
+
+
+
+
+Returns the current user interface (UI) language setting of the device as defined by RFC1766.
+
+
+
+
+
+
+
+**Description framework properties**:
+
+| Property name | Property value |
+|:--|:--|
+| Format | chr (string) |
+| Access Type | Get |
+
+
+
+
+
+
+
+
+
+## Man
+
+
+| Scope | Editions | Applicable OS |
+|:--|:--|:--|
+| :heavy_check_mark: Device
:x: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later |
+
+
+
+```Device
+./DevInfo/Man
+```
+
+
+
+
+Returns the name of the OEM. For Windows 10 for desktop editions, it returns the SystemManufacturer as defined in HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\BIOS\SystemManufacturer. If no name is found, this returns "Unknown".
+
+
+
+
+
+
+
+**Description framework properties**:
+
+| Property name | Property value |
+|:--|:--|
+| Format | chr (string) |
+| Access Type | Get |
+
+
+
+
+
+
+
+
+
+## Mod
+
+
+| Scope | Editions | Applicable OS |
+|:--|:--|:--|
+| :heavy_check_mark: Device
:x: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later |
+
+
+
+```Device
+./DevInfo/Mod
+```
+
+
+
+
+Returns the name of the hardware device model as specified by the mobile operator. For Windows 10 for desktop editions, it returns the SystemProductName as defined in HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\BIOS\SystemProductName. If no name is found, this returns "Unknown".
+
+
+
+
+
+
+
+**Description framework properties**:
+
+| Property name | Property value |
+|:--|:--|
+| Format | chr (string) |
+| Access Type | Get |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Related articles
+
+[Configuration service provider reference](configuration-service-provider-reference.md)
diff --git a/windows/client-management/mdm/devinfo-ddf-file.md b/windows/client-management/mdm/devinfo-ddf-file.md
index dca49363e3..633bc085bd 100644
--- a/windows/client-management/mdm/devinfo-ddf-file.md
+++ b/windows/client-management/mdm/devinfo-ddf-file.md
@@ -1,177 +1,207 @@
---
title: DevInfo DDF file
-description: Learn about the OMA DM device description framework (DDF) for the DevInfo configuration service provider (CSP).
-ms.reviewer:
+description: View the XML file containing the device description framework (DDF) for the DevInfo 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: 12/05/2017
+ms.topic: reference
---
+
+
# DevInfo DDF file
-This topic shows the OMA DM device description framework (DDF) for the **DevInfo** 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 DevInfo configuration service provider.
```xml
-]>
+]>
- 1.2
+ 1.2
+
+
+
+ DevInfo
+ .
+
+
+
+
+ The interior node holding all devinfo objects
+
+
+
+
+
+
+
+
+
+ The interior node holding all devinfo objects
+
+
+
+
+ 10.0.10586
+ 1.0
+ 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;
+
+
- DevInfo
- .
-
-
-
-
-
-
-
-
-
-
-
-
-
- The interior node holding all devinfo objects
-
- urn:oma:mo:oma-dm-devinfo:1.0
-
- 1
-
-
- DevId
-
-
-
-
- An unique device identifier. An application-specific global unique device identifier is provided in this node.
-
-
-
-
-
-
-
-
-
-
- text/plain
-
- 1
-
-
-
- Man
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- text/plain
-
- 1
-
-
-
- Mod
-
-
-
-
- Device model name, as specified and tracked by the mobile operator
-
-
-
-
-
-
-
-
-
-
- text/plain
-
- 1
-
-
-
- DmV
-
-
-
-
- The current management client revision of the device.
-
-
-
-
-
-
-
-
-
-
- text/plain
-
- 1
-
-
-
- Lang
-
-
-
-
- The current language at the device user interface.
-
-
-
-
-
-
-
-
-
-
- text/plain
-
- 1
-
-
+ DevId
+
+
+
+
+ An unique device identifier. An application-specific global unique device identifier is provided in this node.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Man
+
+
+
+
+ Returns the name of the OEM. For Windows 10 for desktop editions, it returns the SystemManufacturer as defined in HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\BIOS\SystemManufacturer. If no name is found, this returns "Unknown".
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Mod
+
+
+
+
+ Returns the name of the hardware device model as specified by the mobile operator. For Windows 10 for desktop editions, it returns the SystemProductName as defined in HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\BIOS\SystemProductName. If no name is found, this returns "Unknown".
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DmV
+
+
+
+
+ The current management client revision of the device.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Lang
+
+
+
+
+ Returns the current user interface (UI) language setting of the device as defined by RFC1766.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Ext
+
+
+
+
+ Parent node for nodes extended by Microsoft.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ICCID
+
+
+
+
+ Retrieves the ICCID of the first adapter.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
```
-## Related topics
-
-
-[DevInfo configuration service provider](devinfo-csp.md)
-
-
-
-
-
-
-
-
-
+## Related articles
+[DevInfo configuration service provider reference](devinfo-csp.md)