Settings and Properties in Windows Embedded Standard 7 (Standard 7 SP1)
7/8/2014
Image Configuration Editor displays the properties and settings of a selected component or package in the Settings pane. The component settings that you can edit for each configuration pass can be managed and viewed in the Settings pane. You can also view properties and IDs where applicable. For packages, the Settings pane displays the Standard 7 feature selections that you can edit**.** Settings that are not available for that component or package appear dimmed. Settings that have been edited appear in bold.
Component Settings
Component settings are the configurable aspects of each component in a Standard 7 installation for unattended setup. For example, you can configure the Internet Explorer component setting Home_Page to open to a particular URL by configuring the default value of the setting in the Settings pane of Image Configuration Editor.
Component Properties
The component properties are nonconfigurable attributes of the component. Component properties display differently when the component is added to the currently open answer file. The following table lists component properties for components that have been added to an answer file.
Component Property |
Description |
|---|---|
ApplicableConfigurationPasses |
The configuration passes to which all child settings are applied. |
Component |
The root ComponentSetting object to which this setting override belongs. |
Path |
The path of the setting from the component. The path appears in the following format: <SettingName1>/<SettingName2>/... |
IsInstalled |
Indicates whether the component was installed. A setting of True means the component is installed. A setting of False means the component is not installed. This means that the setting is ignored and the correct Standard 7 features in the Windows Embedded Core that contain the component are enabled. |
Component IDs
The component ID uniquely identifies the component of the operating system to which the settings belong. The ID contains the name, version, architecture, and so on, for the component selected in the Distribution Share pane or Answer File pane. The following table lists the component IDs.
Component ID |
Description |
|---|---|
Language |
Specifies the language code. For more information about language codes, see this Microsoft Web site. |
Name |
Specifies the long name of the component or package. |
ProcessorArchitecture |
Specifies the processor architecture of the component or package. Some valid values include x86, IA-64, amd64, wow64, and msil. |
PublicKeyToken |
Specifies the public key token of the component or package. This ID is a string of 16 hexadecimal digits. This is the hash value of MS public key. The value is unique for MS and prevents ID collision. |
Version |
Specifies the version of the Standard 7 component or package. |
VersionScope |
Specifies the version scope of the Standard 7 component or package. The possible values are SxS and nonSxS. |
Package Properties
The package properties, as shown in the following table, are nonconfigurable attributes of the package. Package properties appear when you select a package in the Distribution Share pane or Answer File pane.
Package Property |
Description |
|---|---|
Category |
Specifies the category the package is listed under in the distribution share. |
CompanyName |
Specifies the name of the company that created the package. |
Copyright |
Specifies the copyright disclaimer of the package. |
Description |
Specifies the description of the package. |
Footprint |
Specifies the size of the package in bytes. |
Id |
Specifies the identifier for the package. The format is as follows: ProcessorArchitecture_Version_Language_PublicKeyToken_VersionScope |
Keyword |
Specifies the keyword of the package. |
Path |
Specifies the file system path of the package file. This is blank if the package is from a Standard 7 image. |
ReleaseType |
Specifies the PackageReleaseType of this package. |
Revision |
Specifies the revision number of the package. |
SupportInformation |
Specifies the support information for the package. The support information can contain contact information about the package author. |
Package Settings
Package settings are the configurable attributes of the package that is selected in the Answer File pane. Package settings appear only after you select a package in the Answer File pane. After you select a package, you can edit the settings.
Note
The settings for the Windows Embedded Edition Foundation Core package cannot be set because changing the settings of this package will result in an image that is non-functional.
Setting Name |
Available Settings |
|---|---|
Action |
The action to be performed on the package within the answer file. Possible actions are Install, Configure, Remove, or Stage. |
Disabled |
Whether the installed package is disabled or not. |
PermanenceType |
Removable, permanent. Permanence types are members of the PackageActionType. |
PrimarySourcePath |
The primary file system path that is the source of the package file. If the package is from a Standard 7 image, it is blank. |
Shortcut Menu Options
The following menu options are available when you right-click a setting in the Settings pane.
Menu Options |
Description |
|---|---|
Reset Default Value |
Reverts to the default setting. This option removes the entry for the setting from the answer file. The setting remains unchanged after the Unattend.xml answer file has been applied. |
Write Image Value |
Creates an entry for the setting in the answer file that has the value of the setting currently in the Standard 7 image. |
Delete |
Deletes the entered value. |
.NET Types in Image Configuration Editor
Microsoft .NET types appear at the bottom of the Settings pane. Component settings have a type that describes the kind of data that is valid for that setting. Image Configuration Editor maps these types to their equivalent .NET types. The following table lists the possible types that can be associated with component settings.
.NET Type |
Parameters |
Description |
|---|---|---|
System.Byte |
0 to 255 |
Unsigned 8-bit integer |
System.SByte |
-128 to 127 |
Signed 8-bit integer |
System.UInt16 |
0 to 65,535 |
Unsigned 16-bit integer |
System.Int16 |
-32,768 to 32,767 |
Signed 16-bit integer |
System.UInt32 |
0 to 4,294,967,295 |
Unsigned 32-bit integer |
System.Int32 |
-2,147,483,648 to 2,147,483,647 |
Signed 32-bit integer |
System.UInt64 |
0 to 18,446,744,073,709,551,615 |
Unsigned 64-bit integer |
System.Int64 |
–9,223,372,036,854,775,808 to 9,223,372,036,854,775,807 |
Signed 64-bit integer |
System.Boolean |
true | false |
Boolean data |
System.String |
Represents text as a series of Unicode characters |
String data |
Array Types
Some component settings require arrays of data. Image Configuration Editor maps these arrays to their equivalent .NET array types. The following table lists the possible array types associated with component settings.
Type |
Description |
|---|---|
System.String[] |
Array of System.String |
System.Byte[] |
Array of System.Byte |
System.SByte[] |
Array of System.SByte |
List Items
Settings are sometimes organized into groups called list items. List items specify one or more values for a list item type. A list item type may include one or more component settings. For example, you can create multiple favorites links by using the FavoriteItem setting for Internet Explorer.
You add a list item by right-clicking the setting for a container. For example, you can add a FavoriteItem list item by right-clicking the FavoritesList container in the Answer File pane. For more information, see Configure Settings in an Answer File in Image Configuration Editor.
Key Settings for List Items
Each list item must have a unique identifier. This unique identifier is known as the key for that specific list item. When you modify the key setting for the list item, the key identifier appears in brackets ([]) next to the list item in the Answer File pane.
List Item Actions
The following describes actions available for list items when you use Image Configuration Editor.
Add a New List Item
In Image Configuration Editor, you can add several list items to the currently open answer file. In the Setting Action drop-down list, select the AddListItem option. You must also add a unique key setting to the list item. The unique key setting appears in brackets ([]) next to the list item in the tree view of the Answer File pane. A plus sign (+) appears. This indicates the list item is added to the Standard 7 image when the unattended answer file is run.
Delete a List Item
In Image Configuration Editor, you can delete a list item defined in a Standard 7 image (.wim) file. In the Setting Action drop-down list, select the RemoveListItem option. A minus sign (-) appears. This indicates that the list item is deleted from the image when the unattended answer file is run.
Modify a List Item
In Image Configuration Editor, you can modify a list item defined in a Standard 7 image file. To change the default value for an existing list item, select Modify in the Properties pane and enter the updated information under settings. The updated list item setting is added to the answer file.
See Also
Concepts
Image Configuration Editor User Interface
Image Files in Standard 7
Distribution Shares in Standard 7
Answer Files in Standard 7