E.19 Action - Launch Windows Executable
The Add Actions - Launch Windows Executable dialog box lets you specify the Windows executable, command line parameters, and additional optional settings.
Figure E-21 Actions - Launch Windows Executable Dialog Box
You access this dialog box by using the following methods:
-
As part of the process of creating a Directive bundle by using the bundle category. For more information, see Section 2.1, Creating Directive Bundles.
-
In ZENworks Control Center, click the tab, click the underlined link of a bundle in the column of the list, click the tab, click one of the action set tabs (Install, Launch, Verify, Uninstall, Terminate, or Preboot), click the drop-down list, then select an available action.
Command: Specify the location of the Windows executable, including its filename.
You can specify a local path or a network drive. If you specify the local path, you must include the executable’s full path, unless the executable is included in the workstation’s search path. If you specify a network drive, you can use a mapped drive or a UNC path, if the workstation can resolve the path.
Click to browse to and select the desired transform file. You can upload the transform file or you can specify its location.
If you have not installed the Novell File Upload extension on this device, you must do so before you can browse for a file path. For more information, see Novell File Upload Extension.
Command Line Parameters: Specify the command line parameters that you want to run when the executable launches.
Executable Security Level: Click to specify the Window executable’s security level.
The executable can run in either the “user” space or the “system” space. By default, the option is selected, which causes the application to run in the “user” space and inherit the same workstation security level as the logged-in user.
If the logged-in user's security level does not provide sufficient rights and file access to run the executable, you can configure the executable to run in the “system” space or as a dynamic administrator, as described below:
-
Run normal (as logged in user): The executable inherits the logged-in user’s credentials. For example, the executable has the same rights to the registry and the file system as the logged-in user.
Select the executable’s initial window size: , , , or . In Hidden mode, the executable runs normally without a user interface available. This is useful if you want the executable to process something, then go away without user intervention.
-
Run as secure system user (Don't allow system to interact with desktop): The executable is run under the Local System user and inherits Administrator-level credentials. For example, the executable has full rights to the registry and the file system. Because the security level is set to , the executable's interface is not displayed to the user and the executable is only visible in the Task Manager. This option is useful when running executables that require full access to the workstation but require no user intervention.
-
Run as dynamic administrator: A dynamic administrator is an administrator account that is created on the fly to perform certain procedures, such as installing applications. Using a dynamic administrator is helpful when installing applications (some MSI applications, for example) that cannot be installed in the system space. When you select this action, the dynamic administrator is created, it performs the required tasks, and then the account is deleted.
When performing actions as a dynamic administrator, ensure that you select the option in the group box. Selecting this option ensures that the action is completed and the process has terminated and released its resources before ZENworks begins cleaning up and deleting the dynamic administrator account.
NOTE:Performing this action as dynamic administrator on a Windows domain controller fails because Microsoft does not allow the use of local administrator accounts on domain controllers.
Compatibility Mode: Click to specify the Window executable’s compatibility mode.
This option launches the executable in a contained environment. Some executables cannot run on workstations with newer versions of Microsoft Windows because of incompatibility issues. The drop-down list is available after you select the option.
Select this option if you successfully ran an executable on a previous Windows version but you are unable to run the executable on the device’s current Windows version. Select the desired platform from the list.
Display: Click to specify the Window executable’s display settings.
Select the desired display options:
-
Run in 256 colors: Sets the color quality setting to 256 colors while this executable is running. The color quality setting reverts back to your default setting when you close the executable.
-
Run in 640 × 480 screen resolution: Sets the screen resolution setting to 640 × 480 while this executable is running. The screen resolution setting reverts back to your default setting when you close the executable.
-
Disable visual themes: Disables visual themes from being applied to the executable. If you are experiencing problems with menus or buttons on the title bar of the executable, this setting might solve these problems. The theme settings revert back to your default setting when you close the executable.
Input Settings: Click to specify the Window executable’s input settings.
This option temporarily turns off handwriting recognition, speech recognition, and some accessibility features. Turning off text services does not affect multiple languages or keyboards that you have added.
Wait Before Proceeding to Next Action: Click to specify how long the Window executable waits before preceding to the next action.
Specify what happens after the executable launches:
-
No wait: The next action in the list is immediately performed.
-
When launch action is complete: The next action in the list is performed after the launch action completes. Enable this option if you are running the action as a dynamic administrator and you want the profile cleaned up and deleted immediately. If you do not enable this option, the profile is cleaned up and deleted at the device’s next reboot.
-
Wait for _ seconds: Wait the specified number of seconds before proceeding to the next action.
-
Terminate action if wait period exceeded: If you select the option, this option is enabled. If the specified number of seconds is exceeded and the action is not successfully performed, the action terminates.
-
Success return Codes: Specify the non-zero success codes that the executable returns. You can specify multiple success codes separated by commas.
If an executable returns non-zero success codes, you should specify these non-zero success codes while launching the action. For example, explorer.exe in Windows returns a success code of 1. To successfully launch the Explorer application, you should add 1 as the success code while launching the action.
Environment Variables: Lets you add, edit or remove the environment variables as follows:
-
Add: Click to display the Add Environment Variable dialog box. Specify the name and value of the environment variable you want to add. For example, = JAVA_HOME; = C:\java1.4\.
-
Remove: Select the environment variables to remove and click .
-
Edit: Select the environment variable you want to edit, then click . In the Edit Environment Variable dialog box, specify the new value for the variable. For example, = JAVA_HOME; = C:\Program Files\Java\jdk1.6.0_06.