Você poderá configurar diversas opções para o aplicativo do Workspace ONE Access Desktop ao executar seu programa de instalação usando a linha de comando ou um script de implantação.

Opções de linha de comando disponíveis para o instalador do Workspace ONE Access Desktop

Após baixar o arquivo .exe para o instalador do aplicativo do cliente destinado a um sistema do Windows, você poderá consultar uma lista das opções de instalação executando o seguinte comando:
VMware-Identity-Manager-Desktop-n.n.n-nnnnnnn /?
onde n.n.n-nnnnnnn representa a versão do arquivo e o número da compilação. Aparece uma caixa de diálogo que lista as opções de instalação disponíveis para a instalação do aplicativo do cliente usando a linha de comando ou um script de implantação.
Tabela 1. Opções de linha de comando do instalador
Opções de instalador Valor Descrição
/? Exibe as opções de linha de comando do instalador.
/a Executa uma instalação administrativa.

Para obter mais informações, veja a documentação do Windows Installer.

/a caminho completo para a instalação administrativa existente Corrige uma instalação administrativa existente.
/s Oculta a caixa de diálogo de inicialização durante a instalação.

Para fazer a instalação no modo silencioso, use /s /v/qn.

No modo silencioso, nenhuma mensagem, caixa de diálogo ou prompt é exibido durante a instalação. Normalmente, essa opção é usada ao criar um script de implantação para executar o instalador.

/v pares de chave-valor Um conjunto de parâmetros para passar o instalador, especificado como pares de chave-valor. Use o formato key=value. Esses argumentos configuram as opções de tempo de execução para os pacotes ThinApp e para o Workspace ONE Access Desktop em geral.
/c Limpa as informações do registro de instalação.
/l [caminho completo para o arquivo de log] Executa o log detalhado e o salva no arquivo de log especificado.

Caso você não especifique um arquivo de log, um log padrão em %TEMP% será usado.

/x Desempacote o instalador na pasta %TEMP%.

Pares de chave-valor para a opção /v

Você poderá usar os seguintes pares de chave-valor para a opção de instalador /v.

Tabela 2. Chaves para a opção de linha de comando do instalador /v
Chave Valor Descrição
WORKSPACE_SERVER Nome do host ou URL do serviço do Workspace ONE Access

Fornece o nome do host de serviço ou a URL do Workspace ONE Access, para permitir que o aplicativo do Workspace ONE Access Desktop se comunique com o serviço. HTTPS é o protocolo exigido. Marque o valor entre aspas.

Use o seguinte formato:

WORKSPACE_SERVER="https://VMwareIdentityManagerFQDN"

ou

WORKSPACE_SERVER="VMwareIdentityManagerHostName"

Por exemplo:

WORKSPACE_SERVER="https://myserver.mycompany.com"

WORKSPACE_SERVER="myserver"

INSTALL_MODE Um dos seguintes:

COPY_TO_LOCAL

HTTP_DOWNLOAD

RUN_FROM_SHARE

Define o modo de implantação de como o aplicativo do Workspace ONE Access Desktop obtém os pacotes ThinApp no tempo de execução. Os pacotes ThinApp são virtualizados nos aplicativos Windows. Os pacotes ThinApp residem em um compartilhamento de rede integrado com o Workspace ONE Access.

  • COPY_TO_LOCAL: Os pacotes autorizados do usuário são baixados no sistema do Windows do cliente usando uma cópia de arquivo. Quando o usuário inicializa um pacote ThinApp, o aplicativo virtualizado é executado localmente nesse sistema. Antes de o usuário fazer o primeiro download, usar um pacote ThinApp autorizado e continuar a sincronização dos pacotes no sistema do Windows do cliente, o sistema do Windows do cliente deverá ingressar no mesmo domínio do Active Directory no qual o compartilhamento de rede do pacote ThinApp está ingressado. A conta de usuário utilizada para fazer login no sistema do Windows é a conta usada para obter os pacotes ThinApp a partir do compartilhamento de rede. Essa conta deve ter permissões adequadas no compartilhamento de rede para ler e copiar os arquivos a partir do compartilhamento de rede.
    Importante: O modo COPY_TO_LOCAL requer que o compartilhamento do ThinApp seja acessível pela máquina do Windows do usuário.
  • HTTP_DOWNLOAD: Os pacotes autorizados do usuário são baixados no sistema do Windows do cliente usando o protocolo HTTP. Quando o usuário inicializa um pacote ThinApp, o aplicativo virtualizado é executado localmente nesse sistema. O aplicativo do Workspace ONE Access Desktop usa a conta do sistema do Workspace ONE Access do usuário para se autenticar no Workspace ONE Access a fim de obter a lista dos pacotes autorizados do usuário para download. A conta de usuário de compartilhamento fornecida no console do Workspace ONE Access para habilitar o acesso com base em conta ao compartilhamento de rede dos pacotes ThinApp usados pelo Workspace ONE Access para acessar os pacotes do ThinApp a partir do repositório. Essa conta de usuário de compartilhamento para o Workspace ONE Access precisa ler a permissão no compartilhamento de rede. A conta que o usuário utilizou para fazer login no sistema do Windows e a conta de sistema do usuário no Workspace ONE Access não precisam de nenhuma permissão no compartilhamento de rede. O cliente do sistema do Windows não tem de ingressar no mesmo domínio no qual o compartilhamento de rede dos pacotes ThinApp está ingressado. Esse método de download é normalmente mais lento do que outros. O benefício desse modo reside no fato de o sistema do Windows do cliente não ter de ingressar no domínio do Active Directory para obter e executar o aplicativo virtualizado.
    Importante: Para que a opção HTTP_DOWNLOAD funcione, a integração dos pacotes ThinApp no Workspace ONE Access deve ser configurada para acesso com base em conta.
    Importante: Para o Workspace ONE Access 2.6 e posterior no Windows 2008 R2 ou no Windows 7, a opção HTTP_DOWNLOAD não funcionará, a menos que você habilite o TLS 1.0 no Workspace ONE Access ou habilite o TLS 1.1. ou 1.2 no sistema do Windows 2008 R2 ou do Windows 7. Para habilitar o TLS 1.0 no Workspace ONE Access, consulte o artigo 2144805 da Base de Conhecimento. Para habilitar o TLS 1.1 ou 1.2 no sistema do Windows, consulte a documentação da Microsoft em https://support.microsoft.com/en-us/kb/3140245.
    Importante: O modo HTTP_DOWNLOAD requer que a URL do IDP seja acessível pelo sistema do Windows do usuário.
  • RUN_FROM_SHARE: O aplicativo virtualizado é transmitido para o sistema do Windows do cliente a partir do compartilhamento de rede quando o usuário inicializa o pacote ThinApp. A opção RUN_FROM_SHARE é mais adequada aos sistemas do Windows que sempre tenham conectividade com o compartilhamento de rede onde os pacotes ThinApp residirem, porque os pacotes ThinApp não estão presentes no sistema do Windows e os aplicativos virtualizados são executados apenas se o sistema do Windows puder conectar-se ao compartilhamento de rede. O cliente do sistema do Windows deve ingressar no mesmo domínio do Active Directory no qual o compartilhamento de rede dos pacotes ThinApp está ingressado. A conta de usuário utilizada para fazer login no sistema do Windows é a conta usada para obter os pacotes ThinApp a partir do compartilhamento de rede. Essa conta deve ter permissões adequadas no compartilhamento de rede para ler e executar os arquivos a partir do compartilhamento de rede.
    Importante: O modo RUN_FROM_SHARE requer que o compartilhamento do ThinApp seja acessível pela máquina do Windows do usuário.

O valor padrão é COPY_TO_LOCAL.

O compartilhamento de rede deverá ter as permissões adequadas de compartilhamento e de arquivo configuradas para cada um dos modos. Consulte Instalação e Configuração do Workspace ONE Access.

Importante: Ao instalar o Workspace ONE Access Desktop em desktops do Horizon flutuantes, use a opção RUN_FROM_SHARE para evitar copiar os pacotes ThinApp nesses sistemas de desktop do Horizon independente.

Quando o aplicativo do Workspace ONE Access Desktop é instalado com uma dessas configurações, a conta de usuário que faz login no sistema do Windows deve ter as permissões de compartilhamento e os arquivos adequados no compartilhamento de rede para que seja possível obter os pacotes ThinApp:

  • A opção RUN_FROM_SHARE
  • A opção COPY_TO_LOCAL, sem também ter a opção AUTO_TRY_HTTP habilitada e o acesso com base em conta configurado no Workspace ONE Access
POLLING_INTERVAL Frequência em segundos Configura a frequência, em segundos, de sincronização entre o aplicativo Workspace ONE Access Desktop instalado e o Workspace ONE Access para verificar os novos pacotes ou direitos ThinApp. Caso não esteja especificado, aplica-se o valor padrão de 300 segundos (5 minutos).

Por exemplo:

POLLING_INTERVAL=600

ENABLE_AUTOUPDATE 0 ou 1

Habilita ou desabilita a verificação de atualização automática e a atividade de download. Caso esteja habilitado, o aplicativo do Workspace ONE Access Desktop instalado automaticamente verificará se um novo aplicativo está disponível para download. Caso uma nova versão esteja disponível, o aplicativo do Workspace ONE Access Desktop será baixado automaticamente e atualizado para a versão mais recente. Essa opção já vem habilitada.

Defina o valor dessa variável para 0 de maneira que a atualização seja desabilitada. Caso não esteja especificado, aplica-se o valor padrão 1.

A instalação das atualizações automáticas exige privilégios de administrador.
SHARED_CACHE 0 ou 1

Determina se o cache do pacote ThinApp está localizado em uma pasta comum no sistema do Windows no qual o aplicativo do cliente está sendo instalado. Defina o valor dessa variável em 1 para especificar que todos os usuários de conta do sistema do Windows compartilhem uma localização de cache comum. Via de regra, a pasta comum é %ProgramData%\VMware\Identity Manager Desktop\thinapp.

Caso não esteja especificada, aplica-se o valor padrão 0, e cada conta de usuário obtém seu próprio cache, e o valor padrão é %LOCALAPPDATA%\VMware\Identity Manager Desktop\thinapp.

Observação: Caso você especifique um cache compartilhado, o aplicativo Workspace ONE Access Desktop não excluirá os pacotes ThinApp desse cache compartilhado. Porque SHARED_CACHE=1 indica que todas as contas de usuário do sistema do Windows compartilham o mesmo local; os pacotes devem permanecer no local compartilhado de modo que os usuários autorizados possam usá-los, mesmo quando um usuário for desautorizado. Ao desautorizar um usuário a partir de um pacote ThinApp, o aplicativo do Workspace ONE Access Desktop cancela o pacote para esse usuário. Outros usuários autorizados nesse sistema do Windows poderão continuar a usar o pacote ThinApp. Você poderá excluir manualmente o cache comum para recuperar o espaço se nenhuma conta de usuário nesse sistema do Windows estiver autorizada a usar os pacotes ThinApp. Cada pacote ThinApp tem sua própria pasta no local do cache.
CACHE_DIR Caminho para a pasta Define o local onde os pacotes ThinApp serão armazenados em cache localmente se os modos de instalação HTTP_DOWNLOAD ou COPY_TO_LOCAL forem usados. Esse valor é definido por sistema, não por usuário; portanto, você deverá usar variáveis de ambiente, tais como %LOCALAPPDATA%, para selecionar os locais específicos de usuário. Certifique-se de escapar do caractere % na linha de comando para evitar a expansão imediata. Por exemplo:

CACHE_DIR=^%LOCALAPPDATA^%\cache

AUTO_TRY_HTTP 0 ou 1

Quando o aplicativo do Workspace ONE Access Desktop é instalado com a opção COPY_TO_LOCAL e o acesso com base em conta é configurado para o Workspace ONE Access, a opção AUTO_TRY_HTTP determina se o cliente deve tentar baixar automaticamente os pacotes ThinApp autorizados do usuário usando o protocolo HTTP, similar à opção HTTP_DOWNLOAD, caso a primeira tentativa de fazer download falhe. Essa opção já vem habilitada. Defina o valor dessa opção para 0 de modo a desabilitá-la automaticamente tentando o protocolo HTTP para o download.

Importante: Para que a opção AUTO_TRY_HTTP funcione, a integração dos pacotes ThinApp no Workspace ONE Access deve ser configurada para acesso com base em conta. Consulte Requisitos do Workspace ONE Access para pacotes ThinApp e o repositório do compartilhamento de rede.
INSTALL_MODULES thinapp Uma lista separada por vírgulas especificando quais módulos instalar. Atualmente, apenas o módulo thinapp está disponível.
MIGRATE_ACTION Um dos seguintes:

MOVE

COPY

NONE

Caso o antigo aplicativo Workspace for Windows esteja instalado, o instalador migrará os dados e as configurações do antigo aplicativo para o novo. O valor padrão é MOVE.

As seguintes configurações são movidas, copiadas ou ignoradas, dependendo do valor que você especificar.

Pacotes ThinApp armazenados em cache

Os pacotes do ThinApp que tiverem sido baixados serão copiados do Workspace para o cache do Windows, %LOCALAPPDATA%\VMware\Horizon ThinApp\PackageCache, para o novo local do cache, %LOCALAPPDATA%\VMware\Identity Manager Desktop\thinapp. Os nomes das pastas dentro da pasta do cache serão alterados.

Importante: As propriedades definidas para Workspace ONE Access durante a instalação têm precedência sobre quaisquer valores migrados para essas propriedades. Por exemplo, se o INSTALL_MODE no Workspace for Windows foi configurado para COPY_TO_LOCAL, e, durante a instalação do Identity Manager Desktop você especificar /v INSTALL_MODE=HTTP_DOWNLOAD, então INSTALL_MODE está definido como HTTP_DOWNLOAD.

Usar as opções do Instalador da Linha de Comando do Workspace ONE Access Desktop

Caso sua instância do Workspace ONE Access tenha uma URL de https://identitymanagerFQDN e o Workspace ONE Access esteja configurado para acesso com base em conta ao seu compartilhamento de rede de pacotes ThinApp, e você deseje instalar silenciosamente o aplicativo do Workspace ONE Access Desktop em múltiplos desktops dessa instância do Workspace ONE Access com essas opções:

  • A opção de instalação do ThinApp configurada para HTTP_DOWNLOAD, porque você espera que esses sistemas do Windows não ingressem no domínio. O Workspace ONE Access provavelmente está configurado para acesso com base em conta ao compartilhamento de rede dos pacotes ThinApp.
  • Os clientes verificam se os novos pacotes e direitos com o Workspace ONE Access a cada 60 segundos.
Você criaria um script que invoca o seguinte comando:
VMware-Identity-Manager-Desktop-n.n.n-nnnnnnn.exe /s
   /v/qn WORKSPACE_SERVER="https://identitymanagerFQDN" INSTALL_MODE=HTTP_DOWNLOAD POLLING_INTERVAL=60
em que você substitui a parte n.n.n-nnnnnnn do nome do arquivo para que o nome corresponda ao seu instalador Workspace ONE Access Desktop baixado.