2.2.2.53 settings:DeviceInformation
The settings:DeviceInformation element is an optional container ([MS-ASDTYPE] section 2.2) element that is used for sending the client device's properties to the server in an initial Provision command request. It is a child of the Provision element (section 2.2.2.44). The settings:DeviceInformation element is defined in the Settings XML namespace, as specified in [MS-ASCMD] section 2.2.3.45.
When the Provision command is used to send the settings:DeviceInformation element, it sends the information about the client device to the server, as specified for the settings:DeviceInformation element under the Settings command in [MS-ASCMD] section 2.2.1.18.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.
Protocol version |
Element support |
---|---|
2.5 |
|
12.0 |
|
12.1 |
|
14.0 |
|
14.1 |
Yes |
16.0 |
Yes |
16.1 |
Yes |
When protocol version 14.1, 16.0, or 16.1 is used, the client MUST send the settings:DeviceInformation element with its contents when sending an initial Provision command request to the server but not on subsequent requests. The settings:DeviceInformation element MUST contain a settings:Set child element ([MS-ASCMD] section 2.2.3.167), and the settings:Set element MUST at least contain a settings:Model child element ([MS-ASCMD] section 2.2.3.115).
When protocol version 14.0, 12.1, or 12.0 is used, the client MUST NOT send the settings:DeviceInformation element in any Provision command request. In these cases, the settings:DeviceInformation element can be used in a Settings command request, as specified in [MS-ASCMD] section 3.1.5.2.
Protocol version 2.5 does not support sending device information to the server.