DevDetail 云解决方案提供商DevDetail CSP

DevDetail 配置服务提供程序处理管理对象,该对象向 OMA DM 服务器提供特定于设备的参数。The DevDetail configuration service provider handles the management object which provides device-specific parameters to the OMA DM server. 这些设备参数不会自动从客户端发送到服务器,但可以使用 OMA DM 命令由服务器查询。These device parameters are not sent from the client to the server automatically, but can be queried by servers using OMA DM commands.

备注

此配置服务提供程序要求从网络配置应用程序访问 ID_CAP_CSP_FOUNDATION 和 ID_CAP_DEVICE_MANAGEMENT_ADMIN 功能。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.

对于 DevDetail CSP,除非节点已存在,否则无法使用 Replace 命令。For the DevDetail CSP, you cannot use the Replace command unless the node already exists.

下面以树格式显示了 OMA 设备管理使用的 DevDetail 配置服务提供程序管理对象。The following shows the DevDetail configuration service provider management object in tree format as used by OMA Device Management. 此配置服务提供商不支持 OMA 客户端预配协议。The OMA Client Provisioning protocol is not supported for this configuration service provider.

.
DevDetail
----URI
--------MaxDepth
--------MaxTotLen
--------MaxSegLen
----DevTyp
----OEM
----FwV
----SwV
----HwV
----LrgObj
----Ext
--------Microsoft
------------MobileID
------------RadioSwV
------------Resolution
------------CommercializationOperator
------------ProcessorArchitecture
------------ProcessorType
------------OSPlatform
------------LocalTime
------------DeviceName
------------DNSComputerName (Added in Windows 10, version 2004)
------------TotalStorage
------------TotalRAM
------------SMBIOSSerialNumber (Added in Windows 10, version 1809)
--------WLANMACAddress
--------VoLTEServiceSetting
--------WlanIPv4Address
--------WlanIPv6Address
--------WlanDnsSuffix
--------WlanSubnetMask
--------DeviceHardwareData (Added in Windows 10, version 1703)

DevTypDevTyp
必需。Required. 以字符串形式返回设备型号名称 /SystemProductName。Returns the device model name /SystemProductName as a string.

支持的操作为 Get。Supported operation is Get.

OEMOEM
必需。Required. 以字符串形式返回原始设备制造商 (OEM) ,如规范 SyncML 设备信息版本 1.1.2 中的定义。Returns the name of the Original Equipment Manufacturer (OEM) as a string, as defined in the specification SyncML Device Information, version 1.1.2.

支持的操作为 Get。Supported operation is Get.

FwVFwV
必需。Required. 返回固件版本,如注册表项HKEY_LOCAL_MACHINE\System\Platform\DeviceTargetingInfo\PhoneFirmwareRevision。Returns the firmware version, as defined in the registry key HKEY_LOCAL_MACHINE\System\Platform\DeviceTargetingInfo\PhoneFirmwareRevision.

对于 Windows 10 桌面版 (家庭版、专业版、企业版和教育版) ,它将返回注册表项 HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\BIOS\BIOSVersion 中定义的 BIOS 版本。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.

支持的操作为 Get。Supported operation is Get.

SwVSwV
必需。Required. 以 MajorVersion.MinorVersion.BuildNumber.QFEnumber 格式返回 Windows 10 操作系统软件版本。Returns the Windows 10 OS software version in the format MajorVersion.MinorVersion.BuildNumber.QFEnumber. 目前,BuildNumber 在手机上返回桌面版和移动版号的生成号。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.

支持的操作为 Get。Supported operation is Get.

HwVHwV
必需。Required. 返回硬件版本,如注册表项中的HKEY_LOCAL_MACHINE\System\Platform\DeviceTargetingInfo\PhoneRadioHardwareRevision。Returns the hardware version, as defined in the registry key HKEY_LOCAL_MACHINE\System\Platform\DeviceTargetingInfo\PhoneRadioHardwareRevision.

对于 Windows 10 桌面版,它将返回 BIOS 版本,如注册表项HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\BIOS\BIOSVersion。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.

支持的操作为 Get。Supported operation is Get.

LrgObjLrgObj
必需。Required. 返回设备是否使用 OMA DM 大型对象处理,如 SyncML 设备信息版本 1.1.2 规范所定义。Returns whether the device uses OMA DM Large Object Handling, as defined in the specification SyncML Device Information, version 1.1.2.

支持的操作为 Get。Supported operation is Get.

URI/MaxDepthURI/MaxDepth
必需。Required. 返回设备支持的管理树的最大深度。Returns the maximum depth of the management tree that the device supports. 默认值为 0 (0) 。The default is zero (0).

支持的操作为 Get。Supported operation is Get.

这是设备支持的最大 URI 段数。This is the maximum number of URI segments that the device supports. 默认值 0 (0) 表示设备支持无限深度的 URI。The default value zero (0) indicates that the device supports a URI of unlimited depth.

URI/MaxTotLenURI/MaxTotLen
必需。Required. 返回用于处理节点或节点属性的任何 URI 的最大总长度。Returns the maximum total length of any URI used to address a node or node property. 默认值为 0 (0) 。The default is zero (0).

支持的操作为 Get。Supported operation is Get.

这是设备支持的 URI 中的最大字符数。This is the largest number of characters in the URI that the device supports. 默认值 0 (0) 表示设备支持长度不受限制的 URI。The default value zero (0) indicates that the device supports a URI of unlimited length.

URI/MaxSegLenURI/MaxSegLen
必需。Required. 返回 URI 中用于处理节点或节点属性的任何 URI 段的总长度。Returns the total length of any URI segment in a URI that addresses a node or node property. 默认值为 0 (0) 。The default is zero (0).

支持的操作为 Get。Supported operation is Get.

这是设备在单个 URI 段中可以支持的最大字符数。This is the largest number of characters that the device can support in a single URI segment. 默认值 0 (0) 表示设备支持长度不受限制的 URI 段。The default value zero (0) indicates that the device supports URI segment of unlimited length.

Ext/Microsoft/MobileIDExt/Microsoft/MobileID
必需。Required. 返回与手机网络关联的移动设备 ID。Returns the mobile device ID associated with the cellular network. 对于没有手机网络支持的设备,返回 404。Returns 404 for devices that do not have a cellular network support.

支持的操作为 Get。Supported operation is Get.

为 GSM 和 UMTS 网络返回 IMSI 值。The IMSI value is returned for GSM and UMTS networks. 如果对此元素进行查询,CDMA 和全球电话将返回"404 未找到状态代码"错误。CDMA and worldwide phones will return a 404 Not Found status code error if queried for this element.

Ext/Microsoft/RadioSwVExt/Microsoft/RadioSwV
必需。Required. 返回无线堆栈软件版本号。Returns the radio stack software version number.

支持的操作为 Get。Supported operation is Get.

Ext/Microsoft/ResolutionExt/Microsoft/Resolution
必需。Required. 返回设备的 UI 屏幕分辨率 (示例 " :480x800 ") 。Returns the UI screen resolution of the device (example: "480x800").

支持的操作为 Get。Supported operation is Get.

Ext/Microsoft/CommercializationOperatorExt/Microsoft/CommercializationOperator
必需。Required. 返回移动运营商的名称(如果存在);否则,它将返回 404。。Returns the name of the mobile operator if it exists; otherwise it returns 404..

支持的操作为 Get。Supported operation is Get.

Ext/Microsoft/ProcessorArchitectureExt/Microsoft/ProcessorArchitecture
必需。Required. 以 arm 或 " " x86 返回设备的 " 处理器体系结构 " 。Returns the processor architecture of the device as "arm" or "x86".

支持的操作为 Get。Supported operation is Get.

Ext/Microsoft/ProcessorTypeExt/Microsoft/ProcessorType
必需。Required. 返回设备上记录的设备处理器SYSTEM_INFO。Returns the processor type of the device as documented in SYSTEM_INFO.

支持的操作为 Get。Supported operation is Get.

Ext/Microsoft/OSPlatformExt/Microsoft/OSPlatform
必需。Required. 返回设备的操作系统平台。Returns the OS platform of the device. 对于 Windows 10 桌面版,它将返回 HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProductName 中定义的 ProductName。For Windows 10 for desktop editions, it returns the ProductName as defined in HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProductName.

支持的操作为 Get。Supported operation is Get.

Ext/Microsoft/LocalTimeExt/Microsoft/LocalTime
必需。Required. 以 ISO 8601 格式返回客户端本地时间。Returns the client local time in ISO 8601 format.

支持的操作为 Get。Supported operation is Get.

Ext/Microsoft/DeviceNameExt/Microsoft/DeviceName
必需。Required. 包含用户指定的设备名称。Contains the user-specified device name.

Windows 10 移动版替换操作支持已添加到 Windows 10 版本 1511 中。Support for Replace operation for Windows 10 Mobile was added in Windows 10, version 1511. 桌面版或 IoT 核心版不支持替换操作。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.

值类型为字符串。Value type is string.

支持的操作包括 Get 和 Replace。Supported operations are Get and Replace.

Ext/Microsoft/DNSComputerNameExt/Microsoft/DNSComputerName
在 Windows 10 版本 2004 中添加。Added in Windows 10, version 2004. 此节点指定设备的 DNS 计算机名称。This node specifies the DNS computer name for a device. 服务器必须显式重新启动设备,此值才能生效。The server must explicitly reboot the device for this value to take effect. 可以在值中嵌入几个宏以用于动态替换。A couple of macros can be embedded within the value for dynamic substitution. 使用这些宏之一将新名称限制为 63 个字符。Using any of these macros will limit the new name to 63 characters. 此节点替换帐户CSP 中的域/计算机名节点This node replaces the Domain/ComputerName node in Accounts CSP.

以下是可用的命名宏:The following are the available naming macros:

Macro 说明Description 示例Example 生成的名称Generated Name
%RAND:<位的>%RAND:<# of digits> 生成指定数量的随机数字。Generates the specified number of random digits. Test%RAND:6%Test%RAND:6% Test123456Test123456
%SERIAL%%SERIAL% 生成从设备派生的序列号。Generates the serial number derived from the device. 如果序列号导致新名称超出 63 个字符的限制,则序列号将被从序列的开头截断。If the serial number causes the new name to exceed the 63 character limit, the serial number will be truncated from the beginning of the sequence. Test-Device-%SERIAL%Test-Device-%SERIAL% Test-Device-456Test-Device-456

值类型为字符串。Value type is string. 支持的操作包括 Get 和 Replace。Supported operations are Get and Replace.

备注

建议将 %SERIAL% 或 与高字符限制一同使用,以减少生成随机名称时 %RAND:x% 发生名称冲突的可能性。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.

在台式电脑上,此设置指定计算机的 DNS 主机名 (计算机名称) 最多 63 个字符。On desktop PCs, this setting specifies the DNS hostname of the computer (Computer Name) up to 63 characters. 用于生成名称中随机数字的 x 个数,其中 x 必须是小于 %RAND:x% 63 的数字。Use %RAND:x% to generate x number of random digits in the name, where x must be a number less than 63. 对于加入域的计算机,唯一名称必须使用 %RAND:x%For domain-joined computers, the unique name must use %RAND:x%. 用于 %SERIAL% 生成嵌入序列号 computer's 的名称。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. 字符限制限制不计算宏和 %RAND:x% 的长度 %SERIAL%The character restriction limit does not count the length of the macros, %RAND:x% and %SERIAL%. 此设置仅在 Windows 10 版本 1803 和更高版本中受支持。This setting is supported only in Windows 10, version 1803 and later. 若要在 Windows 10 版本 1709 和早期版本中更改此设置,请使用 Accounts ComputerAccount下的****ComputerName > 设置To change this setting in Windows 10, version 1709 and earlier releases, use the ComputerName setting under Accounts > ComputerAccount.

Ext/Microsoft/TotalStorageExt/Microsoft/TotalStorage
在 Windows 10 版本 1511 中添加。Added in Windows 10, version 1511. 用于指定从设备上第一个内部驱动器 (总可用存储的整数(以 MB 为单位)可能小于物理存储) 。Integer that specifies the total available storage in MB from first internal drive on the device (may be less than total physical storage).

支持的操作为 Get。Supported operation is Get.

备注

这仅在 Windows 10 移动版中受支持。This is only supported in Windows 10 Mobile.

Ext/Microsoft/TotalRAMExt/Microsoft/TotalRAM
在 Windows 10 版本 1511 中添加。Added in Windows 10, version 1511. 指定设备上可用内存总量(以 MB 为单位)的 (可能小于总物理内存) 。Integer that specifies the total available memory in MB on the device (may be less than total physical memory).

支持的操作为 Get。Supported operation is Get.

Ext/Microsoft/SMBIOSSerialNumberExt/Microsoft/SMBIOSSerialNumber
在 Windows 10 版本 1809 中添加。Added in Windows 10, version 1809. SMBIOS 设备的序列号。SMBIOS Serial Number of the device.

值类型为字符串。Value type is string. 支持的操作为 Get。Supported operation is Get.

Ext/WLANMACAddressExt/WLANMACAddress
活动的 WLAN 连接的 MAC 地址,以 12 位十六进制数表示。The MAC address of the active WLAN connection, as a 12-digit hexadecimal number.

支持的操作为 Get。Supported operation is Get.

备注

Windows 10 桌面版不支持此功能。This is not supported in Windows 10 for desktop editions.

Ext/VoLTEServiceSettingExt/VoLTEServiceSetting
返回打开或关闭 VoLTE 服务。Returns the VoLTE service to on or off. 这仅向移动运营商 OMA-DM 服务器公开。This is only exposed to mobile operator OMA-DM servers.

支持的操作为 Get。Supported operation is Get.

Ext/WlanIPv4AddressExt/WlanIPv4Address
返回活动连接中的 IPv4 Wi-Fi地址。Returns the IPv4 address of the active Wi-Fi connection. 这仅向企业 OMA DM 服务器公开。This is only exposed to enterprise OMA DM servers.

支持的操作为 Get。Supported operation is Get.

Ext/WlanIPv6AddressExt/WlanIPv6Address
返回活动连接中的 IPv6 Wi-Fi地址。Returns the IPv6 address of the active Wi-Fi connection. 这仅向企业 OMA-DM 服务器公开。This is only exposed to enterprise OMA-DM servers.

支持的操作为 Get。Supported operation is Get.

Ext/WlanDnsSuffixExt/WlanDnsSuffix
返回活动连接Wi-Fi后缀。Returns the DNS suffix of the active Wi-Fi connection. 这仅向企业 OMA-DM 服务器公开。This is only exposed to enterprise OMA-DM servers.

支持的操作为 Get。Supported operation is Get.

Ext/WlanSubnetMaskExt/WlanSubnetMask
返回活动连接Wi-Fi掩码。Returns the subnet mask for the active Wi-Fi connection. 这仅向企业 OMA-DM 服务器公开。This is only exposed to enterprise OMA-DM servers.

支持的操作为 Get。Supported operation is Get.

Ext/DeviceHardwareDataExt/DeviceHardwareData
已添加到 Windows 10 版本 1703 中。Added in Windows 10 version 1703. 返回设备的硬件参数的 base64 编码字符串。Returns a base64-encoded string of the hardware parameters of a device.

备注

此节点包含用于标识云中的设备的原始 blob。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 cannot parse the content to get any meaningful hardware information.

支持的操作为 Get。Supported operation is Get.

配置服务提供程序参考Configuration service provider reference