You can modify the scope, description, and other attributes of a global entitlement. You can also disable or enable a previously disabled global entitlement.

Prerequisites

Become familiar with the lmvutil command authentication options and requirements and verify that you have sufficient privileges to run the lmvutil command. See lmvutil Command Authentication.

Procedure

On any View Connection Server instance in the pod federation, run the lmvutil command with the --updateGlobalEntitlement option.

lmvutil --updateGlobalEntitlement --entitlementName name [--scope scope] [--description text] [--disabled] [--enabled] [--fromHome] [--disableFromHome] [--multipleSessionAutoClean] [--disableMultipleSessionAutoClean] [--requireHomeSite] [--disableRequiredHomeSite] [--defaultProtocol protocol]

Option

Description

--entitlementName

Specifies the name of the global entitlement to modify.

--scope

(Optional)

Specifies the scope of the global entitlement. Valid values are as follows:

  • ANY - View looks for desktops on any pod in the pod federation.

  • SITE - View looks for desktops only on pods within the same site as the pod to which the user is connected.

  • LOCAL - View looks for desktops only in the pod to which the user is connected.

--description

(Optional) Specifies a description of the global entitlement. The description can contain between 1 and 1024 characters.

--disabled

(Optional) Disables a previously enabled global entitlement.

--enabled

(Optional) Enables a previously disabled global entitlement.

--fromHome

(Optional) If the user has a home site, causes View to look for desktops on the user's home site. If the user does not have a home site, View begins searching for desktops on the site to which the user is currently connected.

--disableFromHome

(Optional) Disables the --fromHome option functionality if the --fromHome option was previously specified for the global entitlement.

--multipleSessionAutoClean

(Optional) Logs off extra user sessions for the same entitlement. Multiple floating desktop sessions can occur when a pod that contains a session goes offline, the user logs in again and starts another session, and the problem pod comes back online with the original session.

When multiple sessions occur, Horizon Client prompts the user to select a session. This option determines what happens to sessions that the user does not select.

If you do not specify this option, users must manually end their own extra sessions, either by logging off in Horizon Client or by launching the sessions and logging them off.

--disableMultipleSessionAutoClean

(Optional) Disables the --multipleSessionAutoClean option functionality if the --multipleSessionAutoClean option was previously specified for the global entitlement.

--requireHomeSite

(Optional) Causes the global entitlement to be available only if the user has a home site. This option is applicable only when the --fromHome option is also specified.

--disableRequiredHomeSite

(Optional) Disables the --requireHomeSite option functionality if the --requireHomeSite option was previously specified for the global entitlement.

--defaultProtocol

(Optional) Specifies a default display protocol for desktops in the global entitlement. Valid values are RDP and PCOIP.

For example:

lmvutil --authAs adminEast --authDomain domainEast --authPassword "*" --
updateGlobalEntitlement -entitlementName "Agent Sales" --scope ANY
--isDedicated