Configuration Item XML Files
5/4/2012
This section provides information about the XML files created by using the Export command in Configuration Manager console. For more information about how to export a configuration item, see Exporting a Configuration Item.
The XML file provides a list of the properties and values that you set in the New Configuration Item Wizard when you created the configuration item. You can save or share this XML file with other people. To reuse the XML file, import it into Device Manager 2011 using the Import command in the Configuration Manager console. For more information, see Importing a Configuration Item.
Warning
To help ensure the safety of your devices and network, treat the XML files as scripts and follow all security procedures specified by your organization to prevent malicious software from being run on the network. Make sure to only import XML files from a trusted source. Before importing an XML file, open the file to make sure that the file is well formatted, as described in this topic, and that you understand all the settings being imported. Some of the settings being imported from the XML file may not be visible in the UI after being imported. Device Manager 2011 does not confirm that the XML file includes all required properties (or that all properties are valid). If you deploy a configuration package that contains a configuration item with missing or invalid properties, the item will not configure the target device.
The following sample shows a generic example of a configuration item XML file created by using the Export command.
- <ProvisioningItem>
<Property Name="ProvisioningItemUniqueId" Value="ProvisioningItemName" />
<Property Name="Description" Value="DescriptiveComment" />
<Property Name="SourceSite" Value="SiteServerName" />
<Property Name="Type" Value="ProvisioningItemType" />
<Property Name="ProvisioningItemXml" Value="<PropertyList>
<Property Name="NameOfProperty" Value="Setting" />
</PropertyList>" />
<Property Name="SupportedPlatforms" Value=”Platform1,Platform2,…" />
</ProvisioningItem>
Even though you can manually share and reuse the XML file, only a few properties should be changed manually in the XML file. If you want to change additional properties, create a new configuration item using the New Configuration Item Wizard.
The following table shows a basic list of the properties and main sections in the XML file, their definitions, and details about whether the items should be changed manually.
| Property | Definition | Change manually |
|---|---|---|
ProvisioningItemUniqueID |
Name you gave the configuration item. |
Yes |
Description |
Comments you provided about the configuration item. |
Yes |
SourceSite |
Three character Configuration Manager code for the primary server. |
Yes |
Type |
Type of configuration item selected on the second page of the New Configuration Item Wizard. For a list of supported types, see Configuration Items. |
No |
ProvisioningItemXML |
Main properties of the configuration item selected on the third page of the New Configuration Item Wizard. |
No |
SupportedPlatforms |
List of platforms supported by the configuration item. |
No |
The following is a specific example of an XML file for a Registry Settings configuration item. In this example the ServiceDelayMinutes string value of the HKLM\Software\Microsoft\EDM\OSD registry key has been set to 30 minutes. That means the scheduler that checks the membership of Device Manager 2011 collections will run every 30 minutes. The HKLM\Software\Microsoft\EDM\OSD registry key is a 32-bit operating system registry key. Since the bypassWoW setting is set to Yes, the registry key value will also write to an x64-based registry on devices with a 64-bit operating system. This configuration item can be advertised to devices running on thin client, POS, digital signage platforms, and kiosk.
Note
Setting the ServiceDelayMinutes value to zero is not supported.
- <ProvisioningItem>
<Property Name="ProvisioningItemUniqueId" Value="SetCollectionSchedulerRegSetting" />
<Property Name="Description" Value="Set ServiceDelayMinutes to 30 minutes." />
<Property Name="SourceSite" Value="XXX" />
<Property Name="Type" Value="MS.Registry" />
<Property Name="ProvisioningItemXml" Value="<PropertyList>
<Property Name="Name" Value="ServiceDelayMinutes" />
<Property Name="bypassWoW" Value="yes" />
<Property Name="RegistryKey" Value="HKLM\Software\Microsoft\EDM\OSD" />
<Property Name="Value" Value="30" />
<Property Name="Type" Value="REG_SZ" />
</PropertyList>" />
<Property Name="SupportedPlatforms" Value="TC,POS,DS" />
<Property Name="ProgramName" Value="EDMProvisioningRegistry.exe" />
<Property Name="CommandLine" Value="EDMProvisioningRegistry.exe -Key:"HKLM\Software\Microsoft\EDM\OSD" -Value:"ServiceDelayMinutes" -Type:REG_SZ -Data:"30" -bypassWoW:yes" />
</ProvisioningItem>