To modify a global desktop entitlement, use the lmvutil command with the --updateGlobalEntitlement option. To modify a global application entitlement, use the lmvutil command with the --updateGlobalApplicationEntitlement option.

Syntax

lmvutil --updateGlobalEntitlement --entitlementName name [--description text] 
[--disabled] [--enabled] [--fromHome] [--disableFromHome] [--multipleSessionAutoClean] 
[--disableMultipleSessionAutoClean] [--multipleSessionsPerUser] [--disableMultipleSessionsPerUser]
[--requireHomeSite] [--disableRequireHomeSite] [--defaultProtocol value] 
[--scope scope] [--htmlAccess] [--disableHtmlAccess] [--tags tags] [--notags]
lmvutil --updateGlobalApplicationEntitlement --entitlementName name [--description text] 
[--disabled] [--enabled] [--fromHome] [--disableFromHome] [--multipleSessionAutoClean] 
[--disableMultipleSessionAutoClean] [--requireHomeSite] [--disableRequireHomeSite] [--defaultProtocol value]
[--scope scope] [--htmlAccess] [--disableHtmlAccess] [--appVersion value] [--appPublisher value] 
[--appPath value] [--tags tags] [--notags]

Usage Notes

You can use these commands on any Connection Server instance in a pod federation. The Cloud Pod Architecture feature stores new data in the Global Data Layer and replicates that data among all pods in the pod federation.

These commands return an error message if the global entitlement does not exist, the scope is invalid, the Cloud Pod Architecture feature is not initialized, or the commands cannot update the global entitlement.

Options

You can specify these options when you modify a global entitlement. Some options apply only to global desktop entitlements or only to global application entitlements.

Table 1. Options for Modifying Global Entitlements

Option

Description

--entitlementName

Name of the global entitlement to modify.

--scope

Scope of the global entitlement. Valid values are as follows:

  • ANY. Horizon looks for resources on any pod in the pod federation.

  • SITE. Horizon looks for resources only on pods in the same site as the pod to which the user is connected.

  • LOCAL. Horizon looks for resources only in the pod to which the user is connected.

--description

(Optional) 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 Horizon to begin searching for resources on the user's home site. If the user does not have a home site, Horizon begins searching for resources on the site to which the user is currently connected.

--disableFromHome

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

--multipleSessionAutoClean

(Optional) Logs off extra user sessions for the same entitlement. Multiple 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 function if the --multipleSessionAutoClean option was previously specified for the global entitlement.

--multipleSessionsPerUser

(Optional) Allows users to initiate separate desktop sessions from different client devices. Users that connect to the global entitlement from different client devices receive different desktop sessions. To reconnect to an existing desktop session, users must use the same device from which that session was initiated. If you do not use this setting, users are always reconnected to their existing desktop sessions, regardless of the client device that they use. Applies only to floating desktop entitlements.

--disableMultipleSessionsPerUser

(Optional) Disables the --multipleSessionsPerUser option function if the --multipleSessionsPerUser 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.

--disableRequireHomeSite

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

--defaultProtocol

(Optional) Default display protocol for desktops or applications in the global entitlement. Valid values are RDP, PCOIP, and BLAST for global desktop entitlements and PCOIP and BLAST for global application entitlements.

--htmlAccess

(Optional) When you specify this option, users can use the HTML Access feature to access resources in the global entitlement. With HTML Access, end users can use a Web browser to access remote resources and are not required to install any client software on their local systems.

--disableHtmlAccess

(Optional) Disables the --htmlAccess option function if the --htmlAccess option was previously specified for the global entitlement.

--appVersion

(Optional) Version of the application.

Applies only to global application entitlements.

--appPublisher

(Optional) Publisher of the application.

Applies only to global application entitlements.

--appPath

(Optional) Full pathname of the application, for example, C:\Program Files\app1.exe.

Applies only to global application entitlements.

--tags

(Optional) Specifies one or more tags that restrict access to the global entitlement from Connection Server instances. To specify multiple tags, type a quoted list of tag names separated by a comma or semicolon.

--notags

(Optional) Removes tags from the global entitlement if the --tags option was previously used to add tags to the global entitlement.

Examples

lmvutil --authAs adminEast --authDomain domainEast --authPassword "*" --updateGlobalEntitlement --entitlementName "Windows 8 Desktop" --scope ANY --isDedicated
lmvutil --authAs adminEast --authDomain domainEast --authPassword "*" 
--updateGlobalApplicationEntitlement --entitlementName "Microsoft Office PowerPoint" --scope ANY