Share via

Poll Request to the Server

  • Article

The end user or administrator configures the device with default settings to poll a specific server at a specific time and interval. This is done either through the API or through the user interface (UI). The poll server through its response to the device poll may change these settings.

The polling interval is specified in the registry. This polling interval specifies how often to contact the server. If a connection attempt fails for a period, the client will retry after the retry timeout. This will be repeated depending on the number of entries specified in the registry. The default values are one hour for the polling interval and 3 minutes for retries with the maximum number of retries being five. The poll task never expires and is thus, always rescheduled.

The polling is achieved as a standard HTTP POST. The polling format describes the format of the Poll data that is sent to the server, which is the device proxy in the case of Microsoft Systems Management Server.

The polling information sent to the server has two parts:

  • HTTP headers
  • POST data in XML

Poll Request XML Elements

The following table shows the Poll request XML elements.

Element Description
DevicePoll Root element of the Poll document.
ManagementSystem Top-level element of the section that provides information about the management system being used to manage this device.
Name Name of the management system being used to manage this device.
Version Version of the management system being used to manage this device.
Identification Top-level element of the section that provides information used to identify the device.
ID Unique ID of the device.
DeviceName Name of the device.
UserName Username of the device user.
Domain Domain of the device user.
Platform Software platform of the device.
Processor Type of processor running the device.
codePage Codepage used when generating the XML document.
SystemDefaultLCID System-default locale identifier currently used by the device.
NetworkAdapter Top-level element of the section that provides information about the device's connection to the network.
IPAddress IP address of the device.
IPSubnet IP subnet of the device.
MAC MAC address of the device's network adapter.
Connection Top-level element of the section that provides additional information about the connection context. This information is specifically relevant to the nature of the connection between managed device and management server.
AuthorizationToken An authorization token optionally used as part of client authentication.
Timestamp A timestamp value maintained by the management server.

Poll Request Schema

The following schema is recommended for a Poll request to the server.

<DevicePoll xmlns="Default XML namespace for the XML document">
  <ManagementSystem>
    <Name>"Name of the management system"</Name>
    <Version>"Version of the management system"</Version>
  </ManagementSystem>
  <Identification>
    <ID>"Unique ID of the device"</ID>
    <DeviceName>"Device's name"</DeviceName>
    <UserName>"Device user's username"</UserName>
    <Domain>"Device user's domain"</Domain>
    <Platform>"Software platform of the device"</Platform>
    <Processor>"Processor running on the device"</Processor>
    <CodePage>"Codepage used when generating XML document"</CodePage>
    <SystemDefaultLCID>"System-default locale ID"</SystemDefaultLCID>
    <NetworkAdapter>
      <IPAddress>"Device IP address"</IPAddress>
      <IPSubnet>"Device IP subnet"</IPSubnet>
      <MAC>"Device network adapter MAC address"</MAC>
    </NetworkAdapter>
  </Identification>
  <Connection>
    <AuthorizationToken>"Authorization token"</AuthorizationToken>
    <Timestamp>"Management server's timestamp</Timestamp>
  </Connection>
</DevicePoll>

Poll Request Example

The following code example shows a Poll request to the server.

X-Device-UUID:43004500500043000000434550434B5335343934350000000000
X-Device-Auth:d302b047-c9a2-4a11-a392-df84195d2808
X-Device-Timestamp:4/7/2002 10:09:27 PM
X-Device-Action:Poll
<DevicePoll xmlns="https://www.microsoft.com/DeviceManagement.xsd">
  <ManagementSystem>
    <Name> Systems Management Server Device Management</Name>
    <Version>2.5.0.0</Version>
  </ManagementSystem>
  <Identification>
    <ID>43004500500043000000434550434B5335343934350000000000</ID>
    <DeviceName>WindowsCE</DeviceName>
    <UserName>KenKwok</UserName>
    <Platform>CEPC platform</Platform>
    <Processor>586</Processor>
    <CodePage>437</CodePage>
    <SystemDefaultLCID>1033</SystemDefaultLCID>
    <NetworkAdapter>
      <IPAddress>172.18.42.254</IPAddress>
      <IPSubnet>255.255.252.0</IPSubnet>
      <MAC>172.18.42.254</MAC>
    </NetworkAdapter>
  </Identification>
  <Connection>
    <AuthorizationToken>316e47ab-5ca7-4531-a0a7 8b095eafb7df</AuthorizationToken>
    <Timestamp>4/7/2002 10:09:27 PM</Timestamp>
  </Connection>
</DevicePoll>

See Also

Device Management Operation

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.