Share via

Instruction Response from the Server

  • Article

The download instructions are an XML document and contain information about one or more downloads and each download can include the download of one or more files. Download instructions can optionally include the command line of a program to run after the download is completed.

Instruction Response XML Elements

The following table shows the Instruction Response XML elements.

Element Description
Instructions Root element of the Instructions Response document.
Required Specifies whether the download and execution of the package is mandatory or optional.
Name Name of the package.
ShortDescription A short description of the package.
LongDescription A longer description of the package.
PackageSize Size of the package, in bytes.
Flags A set of flags (32 bit bitmask) used to encode network connection-related constraints.
StartTime Time at which this package is to be downloaded and executed.
Recurrence Top-level element of the section that defines the behavior of recurring packages.
Interval How often the, optional, download and execution of the package is to occur.
Behavior Defines the download behavior of recurring packages. Following the initial download and execution, subsequent packages will either be downloaded and executed or just executed. If they are just executed, no additional downloads follow the initial download.
LocalDestination Location on the client where the package contents are to be saved.
CommandLine Command line to be executed for this package.

Instruction Response Schema

The following schema shows the Instruction response.

<Instructions xmlns="Default XML namespace used for the XML document">
  <Package>
    <ID>"Package Unique ID"</ID>
    <Required>"Whether or not the download of this package is required"</Required>
    <Name>"Name of the package"</Name>
    <ShortDescription>"Short description of package"</ShortDescription>
    <LongDescription>"Long description of package"</LongDescription>
    <Flags>"Set of flags used to encode network connection-related constraints"</Flags>
    <StartTime UTC ="Whether or not UTC time">"Time when package should be downloaded and executed"</StartTime>
    <Recurrence>
      <Interval>"How often to download and execute the package"</Interval>
      <Behavior>"Download behavior of package"</Behavior>
    </Recurrence>
    <LocalDestination>"Where the package will be saved on client" </LocalDestination>
    <CommandLine>"Command line to execute for this package"</CommandLine>
    <PackageSize>"Size of the package, in bytes"</PackageSize>
  </Package>
</Instructions>

Instruction Response Sample

The following code example shows the instruction response from the server.

<Instructions xmlns="https://www.microsoft.com/DeviceManagement.xsd">
  <Package>
    <ID>9A437CA5-5B17-4486-9E87-260742074A72</ID>
    <Required>true</Required>
    <Name>sample directory download</Name>
    <ShortDescription>short of W directory</ShortDescription>
    <LongDescription>long of W directory</LongDescription>
    <Flags>03 00 00 00</Flags>
    <StartTime UTC="false">2002-08-29 00:00:00</StartTime>
    <Recurrence>
      <Interval>0000-00-01 00:00:00</Interval>
      <Behavior>Download and Execute</Behavior>
    </Recurrence>
    <LocalDestination>\temp</LocalDestination>
    <CommandLine>install.cab</CommandLine>
    <PackageSize>9448526</PackageSize>
  </Package>
</Instructions>

See Also

Device Management Operation

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.