Applications

Controls the creation of application shortcuts.

Tip:

  • You can use Citrix Studio to edit the application settings and then add an executable file path that points to VUEMAppCmd.exe. VUEMAppCmd.exe ensures that the Workspace Environment Management agent finishes processing an environment before Citrix Virtual Apps and Desktops published applications are started. For more information, see Editing application settings using Citrix Studio.

  • You can use dynamic tokens to extend Workspace Environment Management actions to make them more powerful.

Application List

Displays a list of your existing application resources. You can use Find to filter the list by name or ID.

A general workflow to add and assign an application is as follows:

  1. Go to the Administration Console > Actions > Applications > Application List tab, click Add. Alternatively, right-click the blank area and then select Add in the context menu. The New Application window appears.

    1. On the General tab, type the required information and select an application type as needed.

    2. On the Options tab, add an icon for the application and configure settings as needed.

    3. On the Advanced Settings tab, configure more options for the application.

    4. Click OK to save changes and to exit the New Application window.

  2. Go to the Administration Console > Assignments > Action Assignment tab.

    1. Double-click the user or user group to which you want to assign the application.

    2. Select the application and click the right arrow (>) to assign it.

    3. In the Assign Filter window, select Always True and then click OK. The application moves from the Available pane to the Assigned pane.

    4. In the Assigned pane, configure one or more of the following options for the application: Create Desktop, Create Quick Launch, Create Start Menu, Pin To TaskBar, Pin To Start Menu, and Auto Start.

The assignment might take some time to take effect, depending on the value you specified for SQL Settings Refresh Delay on the Advanced Settings > Configuration > Service Options tab. Perform the following steps for the assignment to take effect immediately if needed.

  1. Go to the Administration Console > Administration > Agents > Statistics tab and then click Refresh.

  2. Right-click the agent and then select Refresh Workspace Agent(s) in the context menu.

The General tab

Name. The display name of the application shortcut, as it appears in the application list.

Description. Lets you specify additional information about the application.

Application Type. The type of application the shortcut opens. The user interface differs depending on your selection.

  • Installed application. Lets you create a shortcut that opens an application installed on the user’s machine. If selected, prompts you to complete the following:

    • Command Line. Type the full path of the application that resides on the user’s machine. Click Browse to see the listed applications and to understand the file path format.
    • Working Directory. Type the full path to a folder on the user’s machine as a working folder for the application. This field populates automatically after you type the full path in the Command Line field.
    • Parameters. Type launch parameters for the application if needed.
  • File/Folder. Lets you create a shortcut that opens the target file or folder on the user’s machine when a user clicks the shortcut icon. If selected, prompts you to complete the following:

    • Target. Type the full path to the target file or folder.
  • URL. Lets you add the URL of an application. If selected, prompts you to complete the following:

    • Shortcut URL. Type the URL of an application.
  • StoreFront store. Lets you add an application that is based on a StoreFront store. If selected, prompts you to complete the following:

    • Store URL. Type the URL of a StoreFront store containing the resource you want to start from the shortcut.
    • Store Resource. Add the resource (available from the StoreFront store) that you want to start from the shortcut. Click Browse to browse and select the resource.

    Tip:

    To add an application based on a StoreFront store, you must provide valid credentials. A dialog appears the first time you click Browse to view store resources. The dialog prompts you to type credentials that you use to log on to Citrix Workspace app for Windows. After that, the Store Resources window appears, displaying a list of published applications retrieved by Citrix Workspace app for Windows running on the WEM administration console machine.

Start Menu Integration. Lets you specify where to create the application shortcut on the left side of the Start menu. By default, a new shortcut is created in Programs. To create a custom folder for a shortcut, perform these steps:

  1. Click Select path to open the Start Menu Path Selection window.

  2. In that window, right-click Programs and click Add from the context menu. The Create New Start Menu Folder window appears.

  3. In that window, specify a folder name, click OK.

  4. Click Select to exit the Start Menu Path Selection window.

The Options tab

Icon File. Lets you add an icon for the application. Click Select Icon to type the full path for the icon file you uploaded, select the path from the list, and then click Load. For more information, see To select an icon. Icons are stored in the database as strings.

  • High Resolution Icons Only. Displays only high-definition icons in the list.

Icon Index. This field automatically populates.

Application State. Controls whether the application shortcut is enabled. When disabled, the agent does not process it even if it is assigned to a user.

  • Maintenance Mode. When enabled, prevents users from running the application shortcut. The shortcut icon contains a warning sign to indicate that the shortcut is unavailable. If users click the shortcut, a message appears, notifying them that the application is unavailable. This option lets you proactively manage scenarios where published applications are in maintenance without disabling or deleting those application shortcuts.

    Maintenance Warning sign

Display Name. The name of the shortcut, as it appears in the user environment.

Hotkey. Lets you specify a hotkey for the user to launch the application with. Hotkeys are case sensitive and typed in the following format (for example): Ctrl + Alt + S.

Action Type. Describes what type of action this resource is.

The Advanced Settings tab

Enable Automatic Self-Healing. When selected, the agent automatically recreates application shortcuts on refresh if the user has moved or deleted them.

Enforce Icon Location. Lets you specify the exact location of the application shortcut on the user’s desktop. Values are in pixels.

Windows Style. Controls whether the application opens in a minimized, normal, or maximized window on the user’s machine.

Do Not Show in Self-Services. Hides the application from the agent menu (self-service interface) accessible from the user’s machine. Users open the agent menu by right-clicking the agent icon in the taskbar when the session agent is running in UI mode. If selected, hides the application from both the My Applications menu and the Manage Applications dialog.

Tip:

The Enable Application Shortcuts option controls whether the My Applications option is available in the agent menu. The option is available from the Administration Console > Advanced Settings > UI Agent Personalization > UI Agent Options tab. For more information, see UI Agent Personalization.

Create Shortcut in User Favorites Folder. Creates an application shortcut in the user’s Favorites folder.

To select an icon

To select an icon, complete the following steps:

  1. Hover the mouse over the menu on the WEM service Manage tab.

    WEM service's menu

  2. Click the Citrix Workspace icon.

  3. Click the upload icon to upload the applicable icon file to a Citrix Cloud folder.

  4. On the Administration Console > Actions > Applications > Application List tab, click Add.

  5. In the New Application window, go to the Options tab and then click Select Icon.

  6. In the Icon Selector window, type the full file path for the icon file you uploaded, select the path from the drop-down list, and then click Load. The default folder path is C:\DefaultUploadFolder\. You must type the full file path in the following format: C:\DefaultUploadFolder\iconname. For example:

    • C:\DefaultUploadFolder\iconname.ico
    • C:\DefaultUploadFolder\iconname.exe
  7. In the Icon Selector window, select the applicable icon and then click OK.

Start Menu View

Displays a tree view of your application shortcut resource locations in the Start menu.

Refresh. Refreshes the application list.

Move. Opens up a wizard which allows you to select a location to move the application shortcut to.

Edit. Opens up the application edition wizard.

Delete. Deletes the selected application shortcut resource.

Editing application settings using Citrix Studio

Workspace Environment Management (WEM) provides you with client-side tools to troubleshoot issues you experience. The VUEMAppCMD tool (VUEMAppCmd.exe) ensures that the WEM agent finishes processing an environment before Citrix Virtual Apps and Desktops published applications are started. It is located in the agent installation folder: %ProgramFiles%\Citrix\Workspace Environment Management Agent\VUEMAppCmd.exe.

You can use Citrix Studio to edit the application settings and then add an executable file path that points to VUEMAppCmd.exe. To do so, complete the following steps:

  1. Navigate to the Application Settings > Location page of Citrix Studio.

    Citrix Studio application settings

  2. Type the path of the local application on the end-user operating system.

    • Type the following: %ProgramFiles%\Citrix\Workspace Environment Management Agent\VUEMAppCmd.exe.
  3. Type the command-line argument to specify an application to open.

    • Type the full path to the application that you want to launch through VUEMAppCmd.exe. Make sure that you wrap the command line for the application in double quotes if the path contains blank spaces.
    • For example, suppose you want to launch iexplore.exe through VUEMAppCmd.exe. You can do so by typing the following: ”%ProgramFiles(x86)%\Internet Explorer\iexplore.exe”.

Applications