2.2.3.127 OS

The OS element is an optional child element of the Set element in Settings command requests that specifies the operating system of the client device.

All elements referenced in this section are defined in the Settings namespace.

Command request/response

Parent elements

Child elements

Data type

Number allowed

Settings command DeviceInformation request (section 2.2.1.18)

Set (section 2.2.3.167)

None

string ([MS-ASDTYPE] section 2.7)

0...1 (optional)

Some information about the operating system of the device can be collected from the user agent string that is associated with requests from that client. The mapping from user agent to operating system is not one to one, however, and therefore does not provide sufficient information to troubleshoot and establish an inventory.

The OS element is a string value (up to 1024 characters in length) that enables the client to precisely specify the operating system of the device. The server does not perform any validation of this value, but clients SHOULD<12> use the following convention:

<Operating System Product Name> <Operating System Major Version> <Operating System Minor Version>

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

Yes

12.1

Yes

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes