Program can run

Specifies the logon conditions necessary for the program to run:

• Only when a user is logged on: Prevents the program from running if no user is logged on to the client computer. This is the default setting.
  

• Only when no user is logged on: Prevents the program from running until the user logs off the computer.
  

  Note

  If a user logs on while the installation is running, the program continues to run.

• Whether or not a user is logged on: Enables the program to run with or without a user logged on the client computer.
  

Run with administrative rights

Specifies whether the program runs with administrator credentials. If selected, this option forces the program to run under the local system account on the client computer.

If this option is selected, the following option is available:

• Allow users to interact with this program: Specifies whether to allow users to interact with the program. This check box is available only when the Program can run option is configured for Only when a user is logged on or Whether or not a user is logged on.
  Select this option only for programs that must run in an administrative context and that require the user to interact with the program. If you select this option, the user interface for the program is visible to the logged-on user, and that user can interact with the program.
  Leave this option clear for all programs that do not display any user interface or that display a user interface but do not require the user to interact with the program.
  

  Free program alternative to express files. Note

  If you create a program that is set to Run with administrative rights and you do not select Allow users to interact with this program, the program can fail if it displays a user interface that requires a user to make a selection or click a button. The program waits for user interaction until the program's configured Maximum allowed run time is exceeded, and then it stops if no user interaction is received. If the Maximum allowed run time is set to Unknown, the program's process ends after 12 hours.

After running

Specifies the action that occurs after this program has completed successfully:

• No action required: No restart or log off is required. This is the default value.
  
• Program restarts computer: The program requires a restart and performs this action automatically.
  
• ConfigMgr restarts computer: The computer is restarted automatically by Configuration Manager 2007.
  
• ConfigMgr logs user off: The current user is logged off the computer after the program is completed. Use this option if the program requires that the user log off and then log on again before it can run.
  

Maximum allowed run time

Specifies the maximum time (in minutes) that the program is expected to run on the client computer. This setting can be specified as a whole number greater than zero or as Unknown.

The default setting is 120 minutes.

It is not recommended that you set this value to Unknown because this value is used for two important purposes:

• To monitor the results of the program.
  
• To determine if a program will be launched when maintenance windows have been defined on the client computers.
  

On client computers, the specified value for published programs appears in Run Advertised Programs in Control Panel and helps the user decide if and when to run the advertised program.

Monitoring Program Results

If the value is set as Unknown, Configuration Manager 2007 interprets the maximum allowed run time as 12 hours (720 minutes).

If this maximum run time (whether set by the user or as the default value) is exceeded, Configuration Manager 2007 will stop the program if it is set to Run with administrative rights and the Allow users to interact with this program setting is not selected.

If the program itself is not stopped, Configuration Manager 2007 stops monitoring the program after the maximum allowed run time is exceeded. This allows Configuration Manager 2007 to continue with other software distribution functions, such as running other advertised programs. As a result, Configuration Manager does not do the following:

• Stop the program.
  
• Free up any drives that have been mapped for the advertised program.
  
• Free up any network connections made for the advertised program.
  
• Remove security rights granted to the Client Token account, if any.
  
• Free up operating system resources used by Configuration Manager when running advertised programs.
  

Maintenance Windows

When a maintenance window is in place, a program will be launched only if there is time available remaining in the maintenance window to accommodate the Maximum Allowed Run Time setting (plus the Advertised Programs Client Agent countdown duration).

If an advertised program has the Maximum allowed run time option set to Unknown, however, the available time evaluation proceeds differently. Although an Unknown setting is evaluated by Configuration Manager 2007 as 12 hours, this is for monitoring purposes only. When determining whether there is sufficient time to run a program within a given maintenance window, a setting of Unknown is evaluated as 0 minutes, regardless of whether the program actually takes 1 minute to run or 3 hours.

As a result, a program with the maximum run time set to Unknown will start running during a maintenance window that has even 1 minute available and can continue to run even if it finishes outside the designated maintenance window.

Previous

Goes to the previous page of the wizard.

Next

Goes to the next page of the wizard.

Finish

Goes to the Summary page of the wizard.

Cancel

Discards the settings, and exits the wizard.

E_FAIL_EXECUTION_PENDING 0x80008001

The program cannot be run now from the client UI because :

A restart is in progress.

or

Software Distribution is paused because of a task sequence running

or

Another program is currently running

NOTE: This error code is only returned to the UI and is not present in status messages.

Wait for the restart to finish or the task sequence to finish running.

E_FAIL_DUPLICATE_REQUEST 0x80008002

The program cannot be run again from the client UI because it is already pending, an optional (initiated from the UI) run request already exists for it.

NOTE: This error code is only returned to the UI and is not present in status messages.

Wait for the original application to finish.

E_FAIL_PROGRAM_DISABLED 0x80008004

The program cannot run because it is currently disabled.

Enable the program.

E_FAIL_INVALID_POLICY 0x80008005

This error code can be returned on the client if policy cannot be found or the policy is not valid to run or cancel the requested program.

NOTE: This error code is currently not sent in status messages.

The policy for this program does not exist or is invalid. Create a policy.

E_FAIL_INVALID_PROGRAM 0x80008006

The requested program is not currently pending.

This error code can be returned on the client if the user attempts to continue or cancel the program that is not currently pending. It can also be returned to the task sequence manager (TSM) when TSM requests download locations for packages that are not referenced by the currently running task sequence.

NOTE: This error code is not raised in status messages by Software distribution, but could be raised by task sequence.

The user must not continue or cancel the action of a program.

E_FAIL_SET_CACHEDCONTENTINUSE 0x80008008

Unable to set the CachedContentInUse flag. Failed to indicate the client cache is currently in use.

Check to see if the client cache is in use.

E_FAIL_WMI_ERROR 0x80008009

Failed to read data from WMI. The program could not continue because a system restart is in progress or there is already a run request for this program that requires a reboot.

Wait for the restart/reboot to finish.

E_FAIL_REQUEST_NOT_FOUND 0x80008011

Used for Task Sequence. Failed to reconnect to Task Sequence job because a request cannot be found with the given job ID.

NOTE: Not sent in status message by Software Distribution, but may be used by task sequence.

Start the task sequence job again.

E_FAIL_DEPENDENCY_NOT_RUN 0x80008013

This program cannot run because it depends on another program that has not run successfully before. This error code is returned to task sequence manager when a task sequence Install Software Action step cannot be run because the step has a child program which has not been run before.

Check the program dependency.

E_FAIL_USER_REQUIRED
0x80008014

This error code is returned to task sequence manager when an “Install Software” step cannot be run because the software distribution program in this step is targeted to a user, requires user input or is set to run in user context

User input required.

E_FAIL_INVALID_HASH
0x80008017

The content hash string or hash versions are empty or incorrect in the software distribution policy or the hash verification failed.

Check the hash version.

E_FAIL_CANNOT_RUN_ON_INTERNET 0x80008018

The program cannot run at this time because the client is on the internet.

Wait for client to get off internet.

E_FAIL_EXECUTION_NONFATAL 0x80008100

A non fatal error has been encountered while attempting to run the program. The program execution will be retried if the retry count has not been exceeded.

Wait for the retry.

E_FAIL_EXECUTION_FATAL
0x80009101

A fatal error has been encountered while attempting to run the program. The program execution will not be retried.

Re-run the program.

E_FAIL_INVALID_PROGRAM_OBJECT 0x80009102

An error occurred while creating the execution context.

This is error code indicates that an error was encountered while creating the internal execution context object. This is most likely not due to configuration errors, but could be because of low memory conditions, COM failures or other external errors.

Check the memory and COM failures.

E_FAIL_BAD_ENVIRONMENT_NONFATAL 0x80008103

A non fatal error occurred while preparing to run the program, for example when creating the program execution environment, making a network connection, impersonating the user, determining the file association information, or when attempting to launch the program. This program execution will be retried if the retry count has not been exceeded.

Let the program execution retry.

E_FAIL_BAD_ENVIRONMENT_FATAL 0x8000910A

A fatal error occurred while preparing to run the program, for example when creating the program execution environment, making a network connection, impersonating the user, determining the file association information, or when attempting to launch the program. This program execution will not be retried.

Retry the program execution.

E_FAIL_INVALID_CMDLINE 0x80009104

The command line for this program is invalid.

Try another command line.

E_FAIL_PROGRAM_NOT_MONITORED 0x80008105

An error was encountered while getting the process information for the launched program and the program execution will not be monitored.

Monitor the program.

E_FAIL_NO_CONTENT 0x80009106

Failed to verify the executable file is valid or to construct the associated command line.

Verify the executable file.

E_FAIL_NO_SOURCE 0x80008107

Failed to access all the provided program locations. This program may retry if the maximum retry count has not been reached.

Let program retry to access all of the provided program locations.

E_FAIL_INACCESSIBLE_SOURCE 0x80009108

Failed to access all the provided program locations. This program will not retry.

Retry to access provided programs locations.

E_FAIL_INVALID_MSI 0x80009109

Failed to verify that the given file is a valid installation package.

Verify the installation package.

E_NO_SPACE_IN_CACHE 0x80008201

The content download cannot be performed because there is not enough available space in cache or the disk is full.

Increase cache or disk space.

E_CACHE_TOO_SMALL 0x80008202

The content download cannot be performed because the total size of the client cache is smaller than the size of the requested content.

Increase the cache size.

E_CACHE_IN_USE 0x80008203

The client cache is currently in use by a running program or by a download in progress.

Wait for the running program or download to finish.

E_NO_DP_FOUND 0x80008204

NOTE: this error code is sent at least in status message 10051.

No distribution points were found for the requested content.

Check the distribution points.

E_SWDIST_POLICY_NOT_FOUND 0x80002004

The software distribution policy was not found.

Confirm the software policy exists.

E_FAIL_JOB_PENDING 0x80008250

The computer restart cannot be initiated because a software installation job is in progress.

Wait for software installation to finish or stop the installation.