WillShowUI

  • Article

WillShowUI specifies in what circumstances to display the user interface (UI) for disk configuration. Settings in DiskConfiguration are processed before the UI is displayed, but setting this value to Always or OnError gives notification of success or failure.

Values

Always

Specifies that the UI is always displayed.

OnError

Specifies that the UI is displayed only if an error occurs, even for catastrophic, non-recoverable errors. This is the default value.

Never

Specifies that the UI is never displayed.

WillShowUI only prevents Windows Setup UI pages from being displayed. If a critical error occurs, an error message might be displayed. To avoid displaying the error message, you can use the ErrorHandler.cmd file to automatically run a script to handle the error. For more information about ErrorHandler.cmd, see the OEM Preinstallation Kit (OPK) User's Guide (Opk.chm) or the Windows Automated Installation Kit (AIK) User's Guide (Waik.chm).

Valid Passes

windowsPE

Parent Hierarchy

Microsoft-Windows-Setup | DiskConfiguration | WillShowUI

Applies To

For the list of the supported Windows editions and architectures that this component supports, see Microsoft-Windows-Setup.

XML Example

The following XML output for the DiskConfiguration setting shows how to create three partitions on a hard drive.

<DiskConfiguration>
     <WillShowUI>OnError</WillShowUI>
     <Disk>
          <DiskID>0</DiskID>
          <WillWipeDisk>true</WillWipeDisk>
          <CreatePartitions>
               <CreatePartition>
<!-- Create primary partition, 20 GB -->
                    <Order>1</Order>
                    <Type>Primary</Type>
                    <Size>20000</Size>
               </CreatePartition>
<!-- Create extended partition and fill the rest of the hard disk -->
               <CreatePartition>
                    <Order>2</Order>
                    <Type>Extended</Type>
                    <Extend>true</Extend>
               </CreatePartition>
<!-- Create logical partition within the extended partition, 6 GB -->
               <CreatePartition>
                    <Order>3</Order>
                    <Type>Logical</Type>
                    <Size>6000</Size>
               </CreatePartition>
          </CreatePartitions>
     </Disk>
</DiskConfiguration>

See Also

Concepts

DiskConfiguration