RequiresUserInput (microsoft-windows-shell-setup-firstlogoncommands-synchronouscommand-requiresuserinput)

RequiresUserInput specifies whether the first logon command launches a dialog that requires input from the user.

After the Windows Out of Box Experience (OOBE), the "Preparing Your Desktop" screen appears. This screen prevents users from interacting with the first logon commands, and is intended to efficiently run the logon commands that do not require user input.

If a first logon command requires user input, end users may be forced to wait up to two minutes before they can see the desktop. After this delay, they can interact with the user interface that requires their input. You can use the RequiresUserInput setting to reduce this delay.

Note  

  • If the command that requires user input is not dependent on other commands, consider using an asynchronous command instead. Unlike synchronous commands, asynchronous commands may start and finish in any order. Asynchronous commands cannot delay the appearance of the Windows desktop, even if the asynchronous command requires user input. If an asynchronous command requires user input, the end user will see the input window after the desktop appears. For information about asynchronous commands, see AsynchronousCommand.

  • If you have multiple first logon commands, we recommend that you set the command that requires user input last in the order of first logon commands. This will help to prevent users from interfering with the other first logon commands.

Values

true

Specifies that the first logon command requires user input.

The "Preparing Your Desktop" screen is removed, allowing users to reach the desktop more quickly and provide input.

false

Specifies that the first logon command does not require user input.

The desktop does not appear until first logon command is complete, or until two minutes pass.

This is the default value.

Valid Configuration Passes

oobeSystem

Parent Hierarchy

Microsoft-Windows-Shell-Setup | FirstLogonCommands | SynchronousCommand | RequiresUserInput

Applies To

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

XML Example

The following XML output shows how to specify that one of the first logon commands requires user input.

<FirstLogonCommands>
   <SynchronousCommand wcm:action="add">
      <CommandLine>c:\synccommands\command1.exe</CommandLine>
      <Description>Description of command 1</Description>
      <Order>1</Order>
   </SynchronousCommand>
   <SynchronousCommand wcm:action="add">
      <CommandLine>c:\synccommands\command2.exe</CommandLine>
      <Description>Description of command 2 - This command requires user input</Description>
      <Order>2</Order>
      <RequiresUserInput>true</RequiresUserInput>
   </SynchronousCommand>
</FirstLogonCommands>

SynchronousCommand

AsynchronousCommand