Service - UserEntitlement

Class
VMware.Hv.UserEntitlement
See also
UserEntitlementBase, UserEntitlementId, UserEntitlementInfo
Since
Horizon View 6.0


Service Description

Information about a user entitlement. This represents a simple association between a single user/group and a resource that they can be assigned to.
Examples of associated resources are Desktops, Applications, GlobalEntitlements,GlobalApplicationEntitlements,or URLRedirection Settings.
Individual users/groups and resources may be associated with multiple user entitlements.
List operation is not supported - a list of entitlements can be obtained from the EntitledUserOrGroup service by specific resource reference.

Methods

Methods defined in this Service
UserEntitlement_Create, UserEntitlement_CreateUserEntitlements, UserEntitlement_Delete, UserEntitlement_DeleteUserEntitlements, UserEntitlement_Get, UserEntitlement_GetInfos

UserEntitlement_Create

Add a user entitlement that connects a user/group and a resource. delete/create should be used instead of update.

Privileges

Privilege Description
POOL_ENTITLE If the specified resource is a desktop or application, an entitlement privilege on that resource and its access group is required to create a user entitlement.
FEDERATED_LDAP_MANAGE If the specified resource is a global entitlement or global application entitlement, Global LDAP management is required to create a user entitlement.

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the UserEntitlement used to make the method call.
baseUserEntitlementBase

attributes needed to add a user entitlement

Return Value

Type Description
UserEntitlementIdThe created user entitlement id

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
UnexpectedFaultThrown if an unexpected error occurs while performing the operation.

Events

Event Description
VLSI_DESKTOP_USER_ENTITLEMENT_ADDED If the specified resource is a desktop, sent when successfully creating a user entitlement.
VLSI_DESKTOP_USER_ENTITLEMENT_ADD_FAILED If the specified resource is a desktop, sent when a user entitlement failed to be created.
VLSI_APPLICATION_USER_ENTITLEMENT_ADDED If the specified resource is an application, sent when successfully creating a user entitlement.
VLSI_APPLICATION_USER_ENTITLEMENT_ADD_FAILED If the specified resource is an application, sent when a user entitlement failed to be created.
VLSI_GE_USER_ENTITLEMENT_ADDED If the specified resource is a global entitlement, sent when successfully creating a user entitlement.
VLSI_GE_USER_ENTITLEMENT_ADD_FAILED If the specified resource is a global entitlement, sent when a user entitlement failed to be created.

Show WSDL type definition



UserEntitlement_CreateUserEntitlements

Add multiple user entitlements.
If all resources are the same desktop or application, either all specified user entitlements will exist upon return, or, on error, no new entitlements will be added.

Privileges

Privilege Description
POOL_ENTITLE If a specified resource is a desktop or application, an entitlement privilege on that resource and its access group is required to create that user entitlement.
FEDERATED_LDAP_MANAGE If a specified resource is a global entitlement or global application entitlement, Global LDAP management is required to create that user entitlement.

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the UserEntitlement used to make the method call.
basesUserEntitlementBase[]

array of user entitlement bases to create

Return Value

Type Description
UserEntitlementId[]The created user entitlement ids

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidRequestWhen unauthenticated access users are entitled to Application Pools sourced from Desktops, entitlement fails with Invalid Request exception.
InvalidTypeThrown if the type of any specified argument is invalid.
PartialFailureFaultOn error, if all resources are not the same desktop or application, a PartialFailureFault will be thrown indicating which bases were successfully created and which failed. If all resources are the same desktop or application, this exception will contain at least one EntityAlreadyExists and no other exception types (all specified entitlements are now present, but some were already present). The index of results in the PartialFailureFault correspond to the index of the original base. The result entry will contain either be the normal return type (on success) or an exception (on failure).
UnexpectedFaultThrown if an unexpected error occurs while performing the operation.

Events

Event Description
VLSI_DESKTOP_USER_ENTITLEMENT_ADDED If the specified resource is a desktop, sent for each successfully created user entitlement.
VLSI_DESKTOP_USER_ENTITLEMENT_ADD_FAILED If the specified resource is a desktop, sent for each user entitlement that failed to be created.
VLSI_APPLICATION_USER_ENTITLEMENT_ADDED If the specified resource is an application, sent for each successfully created user entitlement.
VLSI_APPLICATION_USER_ENTITLEMENT_ADD_FAILED If the specified resource is an application, sent for each user entitlement that failed to be created
VLSI_GE_USER_ENTITLEMENT_ADDED If the specified resource is a global entitlement, sent for each successfully created user entitlement.
VLSI_GE_USER_ENTITLEMENT_ADD_FAILED If the specified resource is a global entitlement, sent for each user entitlement that failed to be created.

Show WSDL type definition



UserEntitlement_Delete

Delete a given user entitlement. delete/create should be used instead of update.

Privileges

Privilege Description
POOL_ENTITLE If the specified resource is a desktop or application, an entitlement privilege on that resource and its access group is required to delete the user entitlement.
FEDERATED_LDAP_MANAGE If the user entitlement's resource is a global entitlement or global application entitlement, Global LDAP management is required to delete the user entitlement.

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the UserEntitlement used to make the method call.
idUserEntitlementId

UserEntitlementId of entity to delete.

Return Value

Type Description
None

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
UnexpectedFaultThrown if an unexpected error occurs while performing the operation.

Events

Event Description
VLSI_DESKTOP_USER_ENTITLEMENT_DELETED If the specified resource is a desktop, sent when successfully deleting a user entitlement.
VLSI_DESKTOP_USER_ENTITLEMENT_DELETE__FAILED If the specified resource is a desktop, sent when a user entitlement failed to be deleted.
VLSI_APPLICATION_USER_ENTITLEMENT_DELETED If the specified resource is an application, sent when successfully deleting a user entitlement.
VLSI_APPLICATION_USER_ENTITLEMENT_DELETE_FAILED If the specified resource is an application, sent when a user entitlement failed to be deleted.
VLSI_GE_USER_ENTITLEMENT_DELETED If the specified resource is a global entitlement, sent when successfully deleting a user entitlement.
VLSI_GE_USER_ENTITLEMENT_DELETE_FAILED If the specified resource is a global entitlement, sent when a user entitlement failed to be deleted.

Show WSDL type definition



UserEntitlement_DeleteUserEntitlements

Delete multiple user entitlements.
If all resources are the same desktop or application, either all user entitlements will be deleted, or, on error, none will.

Privileges

Privilege Description
POOL_ENTITLE If any specified resource is a desktop or application, an entitlement privilege on that resource and its access group is required to delete that user entitlement.
FEDERATED_LDAP_MANAGE If a user entitlement's resource is a global entitlement or global application entitlement, Global LDAP management is required to delete that user entitlement.

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the UserEntitlement used to make the method call.
idsUserEntitlementId[]

UserEntitlementIds of entities to delete.

Return Value

Type Description
None

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
PartialFailureFaultOn error, if all resources are not the same desktop or application, a PartialFailureFault will be thrown indicating which bases were successfully deleted and which failed. If all resources are the same desktop or application, this exception will contain at least one EntityNotFound and no other exception types (all specified entitlements are now not present, but some were already not present). The index of results in the PartialFailureFault correspond to the index of the original base. The result entry will contain a fault on failure.
UnexpectedFaultThrown if an unexpected error occurs while performing the operation.

Events

Event Description
VLSI_DESKTOP_USER_ENTITLEMENT_DELETED If the specified resource is a desktop, sent for each successfully deleted user entitlement.
VLSI_DESKTOP_USER_ENTITLEMENT_DELETE_FAILED If the specified resource is a desktop, sent for each user entitlement that failed to be deleted.
VLSI_APPLICATION_USER_ENTITLEMENT_DELETED If the specified resource is an application, sent for each successfully deleted user entitlement.
VLSI_APPLICATION_USER_ENTITLEMENT_DELETE_FAILED If the specified resource is an application, sent for each user entitlement that failed to be deleted
VLSI_GE_USER_ENTITLEMENT_DELETED If the specified resource is a global entitlement, sent for each successfully deleted user entitlement.
VLSI_GE_USER_ENTITLEMENT_DELETE_FAILED If the specified resource is a global entitlement, sent for each user entitlement that failed to be deleted.

Show WSDL type definition



UserEntitlement_Get

Get a user entitlement by Id.

Privileges

Privilege Description
POOL_VIEW IF the user entitlement's resource is a desktop or application, a read privilege is required on that resource and its access group to read that user entitlement.
FEDERATED_LDAP_VIEW If the user entitlement's resource is a global entitlement or global application entitlement, Global LDAP read is required to read that user entitlement.

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the UserEntitlement used to make the method call.
idUserEntitlementId

UserEntitlementId of entity to get.

Return Value

Type Description
UserEntitlementInfoThe user entitlement info

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
UnexpectedFaultThrown if an unexpected error occurs while performing the operation.

Show WSDL type definition



UserEntitlement_GetInfos

Get multiple user entitlement by Id.

Privileges

Privilege Description
POOL_VIEW If any user entitlement's resource is a desktop or application, a read privilege on that resource and its access group is required to read the user entitlements.
FEDERATED_LDAP_VIEW If any user entitlement's resource is a global entitlement or global application entitlement, Global LDAP read is required to read the user entitlements.

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the UserEntitlement used to make the method call.
idsUserEntitlementId[]

UserEntitlementIds of entities to get.

Return Value

Type Description
UserEntitlementInfo[]The user entitlement infos

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
UnexpectedFaultThrown if an unexpected error occurs while performing the operation.

Show WSDL type definition