Unattended Servicing Command-Line Options (Standard 8)
7/8/2014
Review the unattended servicing command-line options for Deployment Image Servicing and Management (DISM) in Windows Embedded 8 Standard (Standard 8).
If you are installing multiple modules or CBS packages to a Windows image, use Deployment Image Servicing and Management (DISM) to apply an Unattend.xml configuration file to the image. Some modules and CBS packages require other modules or CBS packages to be installed first. If there is a dependency requirement, the best way to ensure the correct order of the installation is by using a configuration file. When you use DISM to apply an Unattend.xml configuration file to an image, the unattended settings in the offlineServicing configuration pass are applied to the Windows image.
The following is the base syntax for servicing a Windows image using DISM:
DISM {**/Image:**path_to_image_directory | /Online} [dism_options] {servicing_command} [servicing_argument]
The following servicing options are available to apply an Unattend.xml configuration file to an offline Windows image:
**DISM /Image:path_to_image_directory/Apply-Unattend:**path_to_unattend.xml
The following servicing options are available to apply an Unattend.xml configuration file to a running operating system:
**DISM /Online/Apply-Unattend:**path_to_unattend.xml
The following table provides a description of how an unattended servicing option can be used. These options are not case sensitive.
Option |
Description |
|---|---|
/Get-Help /? |
Displays information about available DISM command-line options and arguments. When used immediately after a command-line option, information about the option and its arguments is displayed. |
/Apply-Unattend:path_to_unattend.xml |
Applies an Unattend.xml file to an image. If you are updating device drivers using an unattended configuration file, you must apply the configuration file to an offline image and specify the settings in the offlineServicing configuration pass. If you are updating modules, CBS packages, or other settings using an unattended configuration file, you can apply the configuration file to an offline or online image. Specify the settings in the offlineServicing configuration pass. |
Limitations
- You cannot use other servicing commands on the same command-line with unattended servicing commands.
- Only a single Unattend.xml configuration file can be specified on any command line.
- When you add modules or CBS packages to an image using an unattended configuration file, the applicability of the module or CBS package is not checked. The configuration file is applied, and the operation completes even if there are modules or CBS packages specified in the configuration file which are not applicable to the image. If you need to check the applicability of a CBS package while you add it to an image, use the DISM command with the /Add-Package option and without the /IgnoreCheck option. If you need to check the applicability of a module while you add it to an image, use the DISM command with the /Add-Module option and without the /IgnoreDependencies flag.
- If you are updating device drivers using an unattended configuration file, you must apply the configuration file to an offline image.
- When you use DISM to apply a configuration file to a running operating system, the configuration file should only contain elements in the offlineServicing configuration pass. This is because some settings in the specialize configuration pass might get applied to the operating system. We recommend that the configuration file you use with DISM only contain settings in the offlineServicing configuration pass.
- When you apply a configuration file using DISM, the configuration file is not cached on the target computer.
See Also
Concepts
Deployment Image Servicing and Management (DISM) Command-Line Options
What Is Deployment Image Servicing and Management?
How Deployment Image Servicing and Management (DISM) Works
International Servicing Command-Line Options
Driver Servicing Command-Line Options
Operating System Module Servicing Command-Line Options
Operating System Package Servicing Command-Line Options