Para modificar um direito de área de trabalho global, use o comando lmvutil com a opção --updateGlobalEntitlement. Para modificar um direito de aplicativo global, use o comando lmvutil com a opção --updateGlobalApplicationEntitlement.

Sintaxe

lmvutil --updateGlobalEntitlement --entitlementName name [--aliasName name | --disableAliasName]
[--description text] [--disabled] [--enabled] [--fromHome] [--disableFromHome] 
[--multipleSessionAutoClean] [--disableMultipleSessionAutoClean] [--multipleSessionsPerUser] 
[--disableMultipleSessionsPerUser] [--requireHomeSite] [--disableRequireHomeSite] 
[--defaultProtocol value] [--scope scope] [--tags tags] [--notags] [--categoryFolder foldername] 
[--disableCategoryFolder] [--clientRestrictions] [--disableClientRestrictions] [--collaboration] 
[--disableCollaboration] [--shortcutLocations {desktop | launcher | desktop,launcher}]
[--backupEntitlementName name] [--disableBackupEntitlement] [--displayAssignedHostName ] [--disableDisplayAssignedHostName] 
[--displayMachineAlias] [--disableDisplayMachineAlias] [--federationAccessGroup name] [--sessionDistributionPolicy {LOAD | SESSION | NONE]
lmvutil --updateGlobalApplicationEntitlement --entitlementName name [--aliasName name | --disableAliasName]
[--description text] [--disabled] [--enabled] [--fromHome] [--disableFromHome] [--multipleSessionAutoClean] 
[--disableMultipleSessionAutoClean] [--requireHomeSite] [--disableRequireHomeSite] [--defaultProtocol value] [--scope scope] 
[--appVersion value] [--appPublisher value] [--appPath value] [--tags tags] [--notags] [--preLaunch] [--disablePreLaunch] 
[--categoryFolder foldername] [--disableCategoryFolder] [--clientRestrictions] [--disableClientRestrictions] 
[--shortcutLocations {desktop | launcher | desktop,launcher}] [--multiSessionMode value] [--backupEntitlementName name] 
[--disableBackupEntitlement] [--federationAccessGroup name] [--sessionDistributionPolicy {LOAD | SESSION | NONE}]

Observações de uso

Você pode usar esses comandos em qualquer instância do Servidor de Conexão em uma federação de pod. O recurso Arquitetura do Cloud Pod armazena novos dados na camada de dados global e replica esses dados entre todos os pods na federação de pods.

Esses comandos retornarão uma mensagem de erro se o direito global não existir, o escopo for inválido, o recurso Arquitetura do Cloud Pod não for inicializado ou os comandos não puderem atualizar o direito global.

Opções

Você pode especificar essas opções ao modificar um direito global. Algumas opções se aplicam apenas a direitos globais de área de trabalho ou apenas a direitos globais de aplicativo.

Tabela 1. Opções para modificar direitos globais
Opção Descrição
--entitlementName Nome exclusivo do direito global a ser modificado.
--aliasName

(Opcional) Nome para exibição do direito global. O nome de exibição aparece para os usuários na lista de áreas de trabalho e aplicativos disponíveis em Horizon Client. O nome de exibição não precisa ser exclusivo. Vários direitos globais podem ter o mesmo nome de exibição. Se você não especificar um nome de exibição, o nome exclusivo aparecerá para os usuários em Horizon Client. O nome de exibição pode conter entre 1 e 64 caracteres.
--disableAliasName

(Opcional) Define o nome para exibição do direito global (opção --aliasName) como o valor padrão. O nome exclusivo do direito global (opção --entitlementName) aparece para os usuários em Horizon Client por padrão. Você pode especificar --aliasName ou --disableAliasName, mas não ambos.
--scope
Escopo do direito global. Os valores válidos são os seguintes:
  • QUALQUER. Horizon 8 procura recursos em qualquer pod na federação de pods.
  • LOCAL. Horizon 8 procura recursos apenas em pods no mesmo site que o pod ao qual o usuário está conectado.
  • LOCAL. Horizon 8 procura recursos apenas no pod ao qual o usuário está conectado.
--description

(Opcional) Descrição do direito global. A descrição pode conter entre 1 e 1.024 caracteres.

--disabled (Opcional) Desativa um direito global ativado anteriormente.
--enabled (Opcional) Ativa um direito global desativado anteriormente.
--fromHome

(Opcional) Se o usuário tiver um site inicial, o Horizon 8 começará a procurar recursos no site inicial do usuário. Se o usuário não tiver um site inicial, Horizon 8 começará a procurar recursos no site ao qual o usuário está conectado no momento.

--disableFromHome

(Opcional) Desativa a função --fromHome para o direito global.

--multipleSessionAutoClean

(Opcional) Faz logoff de sessões de usuário extras para o mesmo direito. Várias sessões podem ocorrer quando um pod que contém uma sessão fica offline, o usuário faz login novamente e inicia outra sessão, e o pod com problema fica online novamente com a sessão original.

Quando ocorrem várias sessões, Horizon Client solicita que o usuário selecione uma sessão. Essa opção determina o que acontece com as sessões que o usuário não seleciona.

Se você não especificar essa opção, os usuários deverão encerrar manualmente suas próprias sessões extras, fazendo logoff em Horizon Client ou inicializando as sessões e fazendo logoff delas.

--disableMultipleSessionAutoClean

(Opcional) Desativa a função --multipleSessionAutoClean para o direito global.

--multipleSessionsPerUser

(Opcional) Ativa a política de várias sessões por usuário, que permite que os usuários iniciem sessões de área de trabalho separadas de diferentes dispositivos cliente. Os usuários que se conectam ao direito de área de trabalho global de diferentes dispositivos cliente recebem diferentes sessões de área de trabalho. Para se reconectar a uma sessão de área de trabalho existente, os usuários devem usar o mesmo dispositivo a partir do qual essa sessão foi iniciada. Se você não ativar essa política, os usuários serão sempre reconectados às suas sessões de área de trabalho existentes, independentemente do dispositivo cliente usado. Aplica-se somente a direitos de área de trabalho flutuante.

--disableMultipleSessionsPerUser

(Opcional) Desativa a política de várias sessões por usuário para o direito de área de trabalho global.

--requireHomeSite

(Opcional) Faz com que o direito global esteja disponível somente se o usuário tiver um site inicial. Essa opção é aplicável somente quando a opção --fromHome também é especificada.

--disableRequireHomeSite

(Opcional) Desativa a função --requireHomeSite para o direito global.

--defaultProtocol

(Opcional) Especifica o protocolo de exibição padrão para áreas de trabalho ou aplicativos no direito global. Os valores válidos são RDP, PCOIP e BLAST para direitos globais de área de trabalho e PCOIP e BLAST para direitos globais de aplicativo.

--appVersion

(Opcional) Versão do aplicativo.

Aplica-se somente a direitos de aplicativo globais.

--appPublisher

(Opcional) Publicador do aplicativo.

Aplica-se somente a direitos de aplicativo globais.

--appPath

(Opcional) Nome do caminho completo do aplicativo, por exemplo, C:\Program Files\app1.exe.

Aplica-se somente a direitos de aplicativo globais.

--tags

(Opcional) Especifica uma ou mais tags que restringem o acesso ao direito global das instâncias do Servidor de Conexão. Para especificar várias tags, digite uma lista entre aspas de nomes de tags separadas por vírgula ou ponto-e-vírgula. Para obter mais informações, consulte Como especificar restrições do servidor de conexão para direitos globais no Horizon 8.

--notags

(Opcional) Remove tags do direito global.

--preLaunch

(Opcional) Ativa a política de pré-lançamento, que inicia a sessão do aplicativo antes que um usuário abra o direito de aplicativo global em Horizon Client. Quando você ativa a política de pré-lançamento, os usuários podem iniciar o direito de aplicativo global mais rapidamente. Todos os pools de aplicativos no direito de aplicativo global devem oferecer suporte ao recurso de pré-inicialização da sessão, e o tempo limite da sessão de pré-inicialização deve ser o mesmo para todos os farms.

--disablePreLaunch

(Opcional) Desativa a política de pré-lançamento para o direito de aplicativo global.

--categoryFolder

(Opcional) Especifica o nome da pasta de categoria que contém um atalho para o direito global em dispositivos cliente. Você pode configurar até quatro níveis de pasta. Um nome de pasta pode ter até 64 caracteres. Para especificar uma subpasta, digite um caractere de barra invertida (\), por exemplo, dir1\dir2\dir3\dir4. Você pode inserir até quatro níveis de pasta. Você não pode começar ou terminar um nome de pasta com uma barra invertida e não pode combinar duas ou mais barras invertidas. Por exemplo, \dir1, dir1\dir2\\}, dir1\\dir2 e dir1\\\dir2 são inválidos. Você não pode inserir Windows palavras-chave reservadas. Você também deve especificar a opção --shortcutLocations para indicar a localização do atalho em um dispositivo cliente Windows. Para obter mais informações, consulte Configurando atalhos para direitos globais no Horizon 8.

--disableCategoryFolder

(Opcional) Remove a pasta de categorias para o direito global.

--clientRestrictions

(Opcional) Ativa a política de restrições do cliente, que restringe o acesso ao direito global a computadores cliente específicos. Para obter mais informações, consulte Implementando restrições de cliente para direitos globais em Horizon 8.

--disableClientRestrictions

(Opcional) Desativa a política de restrições do cliente para o direito global.

--collaboration

(Opcional) Ativa a política de Colaboração de Sessão, que permite que os usuários de sessões de área de trabalho remota convidem outros usuários para ingressar em suas sessões. Todos os pools de áreas de trabalho no direito de área de trabalho global devem oferecer suporte ao recurso Colaboração de Sessão. Aplica-se somente a direitos de área de trabalho globais.

--disableCollaboration

(Opcional) Desativa a política de Colaboração de Sessão para o direito de área de trabalho global.

--shortcutLocations

(Opcional) Use essa opção para modificar ou criar um atalho no dispositivo cliente. Os valores válidos são desktop, que cria o atalho na área de trabalho, e launcher, que cria o atalho no menu Iniciar Windows. Você também pode especificar desktop e launcher, separados por vírgula, para criar atalhos na área de trabalho e no menu Windows Iniciar.

Se você estiver modificando um atalho (ou seja, a pasta de categorias já foi criada), não será necessário especificar a opção --categoryFolder, a menos que você também queira alterar o nome da pasta de categorias.

Se a pasta de categorias ainda não tiver sido criada, você deverá especificar a opção --categoryFolder junto com a opção --shortcutLocations.

Observação: Não use essa opção com a opção --disableCategoryFolder.
--multiSessionMode

(Opcional) Configura o recurso de modo de várias sessões para o direito de aplicativo global. Especifique um dos seguintes valores: DISABLED, ENABLED_DEFAULT_OFF, ENABLED_DEFAULT_ON ou ENABLED_ENFORCED. Para obter mais informações, consulte Ativando o modo de várias sessões para direitos de aplicativos globais em Horizon 8.

--backupEntitlementName (Opcional) Especifica o nome de um direito global de backup. Um direito global de backup entrega áreas de trabalho remotas ou aplicativos publicados quando o direito global primário não pode iniciar uma sessão. Para direitos de área de trabalho globais, o tipo de atribuição de usuário deve ser Flutuante. Para obter mais informações, consulte Implementando direitos globais de backup em Horizon 8.
--disableBackupEntitlement (Opcional) Desativa o direito global de backup.
--displayAssignedHostName (Opcional) Em Horizon Client, exibe o nome do host da máquina atribuída em vez do nome do direito global. Aplica-se somente a direitos de área de trabalho dedicada.
--disableDisplayAssignedHostName (Opcional) Especifica que o nome do host da máquina atribuído não aparece em Horizon Client. Aplica-se somente a direitos de área de trabalho dedicada.
--displayMachineAlias (Opcional) Em Horizon Client, exibe o nome alternativo da máquina atribuída ao usuário, em vez do nome do direito global. Aplica-se somente a direitos de área de trabalho dedicada.
--disableDisplayMachineAlias (Opcional) Especifica que o nome alternativo da máquina não aparece em Horizon Client. Aplica-se somente a direitos de área de trabalho dedicada.
--federationAccessGroup (Opcional) Especifica um grupo de acesso de federação usado para organizar direitos globais para administração delegada. Para obter mais informações, consulte Configurando grupos de acesso de federação em Horizon Console.
--sessionDistributionPolicy (Opcional) Selecione entre:
  • LOAD - Distribui novas sessões uniformemente pelos recursos disponíveis no direito de aplicativo global ou no direito de área de trabalho global com base na carga atual, com as sessões sendo direcionadas para os recursos menos carregados.
  • SESSION - Distribui novas sessões uniformemente entre os recursos disponíveis no direito de aplicativo global ou no direito de área de trabalho global com base na utilização atual. A contagem máxima de sessões do farm ou do host é usada para calcular a utilização da capacidade. Os pods com alta capacidade de sessão recebem mais solicitações de sessão.
  • NONE (padrão) - distribui novas sessões aleatoriamente entre os recursos disponíveis.

Exemplos

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