Citrix DaaS

Instalar VDAs usando a linha de comando

Introdução

Este artigo se aplica à instalação, atualização e personalização de Virtual Delivery Agents (VDAs) em máquinas com sistemas operacionais Windows.

Este artigo descreve como emitir comandos de instalação do VDA. Antes de iniciar uma instalação, consulte Instalar VDAs para saber mais sobre as considerações de instalação, instaladores e o que você especifica durante a instalação.

Instalar um VDA a partir da linha de comando

Para instalar um VDA (e ver o progresso da execução do comando e os valores de retorno), você deve ter privilégios administrativos elevados ou usar Executar como administrador.

  1. Na máquina em que você está instalando o VDA, conecte-se ao Citrix Cloud.
  2. No menu superior esquerdo, selecione My Services > DaaS.
  3. No canto superior direito, clique em Downloads e selecione Download VDA. Você é redirecionado para a página de download do VDA. Encontre o instalador do VDA desejado e clique em Download File.
  4. Após a conclusão do download, execute o nome. Use as opções descritas neste artigo.

    • Para o Virtual Delivery Agent de SO multissessão, execute VDAServerSetup.exe

    • Para o Virtual Delivery Agent de SO de sessão única, execute VDAWorkstationSetup.exe

    • Para o Core Services Virtual Delivery Agent de SO de sessão única, execute VDAWorkstationCoreSetup.exe

Para extrair os arquivos antes de instalá-los, use /extract com o caminho absoluto, por exemplo, .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. (O diretório deve existir. Do contrário, falhará.) Depois, em um comando separado, execute o comando apropriado, usando as opções válidas listadas neste artigo.

  • Para VDAServerSetup_XXXX.exe, execute <extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe

  • Para VDAWorkstationCoreSetup_XXXX.exe, execute <extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe

  • Para VDAWorkstationSetup_XXXX.exe, execute <extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe

Opções de linha de comando para instalar um VDA

As seguintes opções são válidas com um ou mais dos comandos: VDAServerSetup.exe, VDAWorkstationSetup.exe e VDAWorkstationCoreSetup.exe.

  • /components componente[,componente]

    Lista de componentes separados por vírgula para instalar ou remover. Os valores válidos são:

    • VDA: Virtual Delivery Agent

    • PLUGINS: aplicativo Citrix Workspace para Windows

    Para instalar o VDA e o aplicativo Citrix Workspace, especifique /components vda,plugins.

    Se a opção plugins for omitida, somente o VDA será instalado (o aplicativo Citrix Workspace não).

    Esta opção não é válida quando usar o instalador VDAWorkstationCoreSetup.exe. Esse instalador não pode instalar o aplicativo Citrix Workspace.

  • /controllerscontrolador [*controlador*]…”

    FQDNs separados por espaço de Citrix Cloud Connectors com os quais o VDA pode se comunicar, entre aspas retas normais. Não especifique ambas as opções /site_guid e /controllers.

  • /disableexperiencemetrics

    Impede o carregamento automático de análises coletadas durante a instalação, atualização ou remoção para a Citrix.

  • /enable_hdx_ports

    Abre as portas no firewall do Windows exigidas pelo VDA e recursos habilitados (exceto a Assistência Remota do Windows), se o Serviço do Firewall do Windows for detectado, mesmo que o firewall não esteja habilitado. Se estiver usando um firewall diferente (ou se não estiver usando um firewall), você deve configurar o firewall manualmente. Para obter informações sobre portas, consulte Network ports.

    Para abrir as portas UDP do transporte adaptativo HDX, especifique a opção /enable_hdx_udp_ports, além da opção /enable_hdx_ports.

  • /enable_hdx_udp_ports

    Abre portas UDP no firewall do Windows que o transporte adaptativo HDX requer, se o Serviço do Firewall do Windows for detectado, mesmo que o firewall não esteja habilitado. Se estiver usando um firewall diferente (ou se não estiver usando um firewall), você deve configurar o firewall manualmente. Para obter informações sobre portas, consulte Network ports.

    Para abrir as portas que o VDA usa, especifique a opção /enable_hdx_ports, além da opção /enable_hdx_udp_ports.

  • /enable_real_time_transport

    Ativa ou desativa o uso de UDP para pacotes de áudio (RealTime Audio Transport para áudio). Ativar esse recurso pode melhorar o desempenho do áudio. Inclua a opção /enable_hdx_ports se quiser que as portas UDP sejam abertas automaticamente quando o Serviço do Firewall do Windows for detectado.

  • /enable_remote_assistance

    Habilita o recurso de sombreamento na Assistência Remota do Windows para uso com as funções no Monitor. Se você especificar esta opção, a Assistência Remota do Windows abre as portas dinâmicas no firewall.

  • /enablerestore ou /enablerestorecleanup

    (Válido somente para VDAs de sessão única) Permite o retorno automático ao ponto de restauração, se a instalação ou atualização do VDA falhar.

    Se a instalação/atualização for concluída com sucesso:

    • /enablerestorecleanup instrui o instalador a remover o ponto de restauração.
    • /enablerestore instrui o instalador a reter o ponto de restauração, mesmo que ele não tenha sido usado.

    Para obter detalhes, consulte Restaurar em caso de falha de instalação ou atualização.

  • /enable_ss_ports

    Abre portas no Firewall do Windows que são necessárias para o compartilhamento de tela, se o Serviço de Firewall do Windows for detectado, mesmo que o firewall não esteja habilitado. Se estiver usando um firewall diferente (ou se não estiver usando um firewall), você deve configurar o firewall manualmente.

  • /excludecomponente”[,”componente”]

    Impede a instalação de um ou mais componentes opcionais separados por vírgula, cada qual entre aspas retas normais. Por exemplo, instalar ou atualizar um VDA em uma imagem gerenciada pelo MCS exige o componente Machine Identity Service. Os valores válidos são:

    • Machine Identity Service
    • Citrix Profile Management
    • Citrix Profile Management WMI Plug-in
    • Citrix Personalization for App-V - VDA
    • Citrix Supportability Tools
    • Agente Citrix WEM
    • Citrix MCS IODriver
    • Citrix VDA Upgrade Agent
    • Citrix Rendezvous V2

    Excluir o Citrix Profile Management da instalação (/exclude "Citrix Profile Management") afeta o monitoramento e a resolução de problemas de VDAs por meio da guia Monitor. Nas páginas User details e EndPoint, o painel Personalization e o painel Logon Duration falham. Nas páginas Dashboard e Trends, o painel Average Logon Duration exibe dados somente para máquinas que têm o Profile Management instalado.

    Mesmo que você esteja usando uma solução Profile Management de terceiros, a Citrix recomenda que você instale e execute o Citrix Profile Management Service. A ativação do Citrix Profile Management Service não é necessária.

    Se você planeja usar o MCS para provisionar VMs, não exclua o Machine Identity Service.

    Se você especificar /exclude e /includeadditional com o mesmo nome de componente, o componente não é instalado.

    Esta opção não é válida quando usar o instalador VDAWorkstationCoreSetup.exe. Esse instalador exclui automaticamente muitos destes itens.

  • /h ou /help

    Exibe a ajuda do comando.

  • /includeadditionalcomponente”[,”componente”] …

    Inclui a instalação de um ou mais componentes opcionais separados por vírgula, cada qual entre aspas retas normais. Os nomes dos componentes diferenciam maiúsculas de minúsculas.

    Esta opção é útil quando você estiver criando uma implantação do Remote PC Access e quiser instalar componentes que não estão incluídos por padrão. Os valores válidos são:

    • Citrix Profile Management
    • Citrix Profile Management WMI Plug-in
    • Citrix Personalization for App-V - VDA
    • Citrix Supportability Tools
    • Agente Citrix WEM
    • Citrix MCS IODriver
    • Citrix VDA Upgrade Agent
    • Citrix Rendezvous V2

    Se você especificar /exclude e /includeadditional com o mesmo nome de componente, o componente não é instalado.

  • /installdir diretório

    Diretório vazio existente onde os componentes serão instalados. Padrão = c:\Program Files\Citrix.

  • /install_mcsio_driver

    Não use. Em vez disso, use /includeadditional "Citrix MCS IODriver" ou /exclude "Citrix MCS IODriver"

  • /logpath caminho

    Localização do arquivo de log. A pasta especificada deve existir. O instalador não a cria. Padrão = “%TEMP%\Citrix\XenDesktop Installer”

    Esta opção não está disponível na interface gráfica.

  • /masterimage

    Válido somente ao instalar um VDA em uma VM. Configura o VDA como uma imagem. Esta opção é equivalente a /mastermcsimage.

    Esta opção não é válida quando usar o instalador VDAWorkstationCoreSetup.exe.

  • /mastermcsimage

    Especifica que a máquina será usada como uma imagem com Machine Creation Services. Esta opção é equivalente a /masterimage.

  • /masterpvsimage

    Especifica que a máquina será usada como uma imagem com o Citrix Provisioning ou com uma ferramenta de provisionamento de terceiros (como o Microsoft System Center Configuration Manager).

  • /no_mediafoundation_ack

    Reconhece que o Microsoft Media Foundation não está instalado, e vários recursos multimídia HDX não estão instalados e não funcionam. Se esta opção for omitida e o Media Foundation não estiver instalado, a instalação do VDA será malsucedida. A maioria das edições compatíveis do Windows vem com o Media Foundation já instalado, exceto as edições N.

  • /nodesktopexperience

    Válido somente ao instalar um VDA com SO multissessão. Impede a ativação do recurso Enhanced Desktop Experience. Esse recurso também é controlado com a configuração de política Enhanced Desktop Experience Citrix.

  • /noreboot

    Impede uma reinicialização após a instalação. O VDA não pode ser usado até que seja reinicializado.

  • /noresume

    Por padrão, quando uma reinicialização de máquina é necessária durante uma instalação, o instalador continua automaticamente após a conclusão da reinicialização. Para substituir o padrão, especifique /noresume. Isso é útil se você precisar remontar a mídia ou quiser capturar informações durante uma instalação automatizada.

  • /portnumber porta

    Válido somente quando a opção /reconfig é especificada. Número da porta a ativar para comunicações entre o VDA e o Controller. A porta configurada anteriormente é desabilitada, a menos que seja a porta 80.

  • /proxyconfigendereço ou caminho do arquivo PAC

    Válido somente se o comando contiver /includeadditional “Citrix Rendezvous V2”. O endereço ou o caminho do arquivo PAC do proxy para uso com o protocolo Rendezvous. Para obter detalhes do recurso, consulte Protocolo Rendezvous.

    • Formato de endereço proxy: http://<url-or-ip>:<port>
    • Formato de arquivo PAC: http://<url-or-ip>:<port>/<path>/<filename>.pac
  • /quiet ou /passive

    Nenhuma interface de usuário aparece durante a instalação. A única evidência do processo de instalação e configuração está no Gerenciador de Tarefas do Windows. Se esta opção for omitida, a interface gráfica será iniciada.

  • /reconfigure

    Personaliza as configurações de VDA definidas anteriormente quando utilizado com as opções /portnumber, /controllers ou /enable_hdx_ports. Se você especificar esta opção sem também especificar a opção /quiet, a interface gráfica para personalizar o VDA é iniciada.

  • /remotepc

    Válido somente para implantações de Remote PC Access (SO de sessão única) ou conexões agenciadas (SO multissessão).

    Esta opção não é válida quando usar o instalador VDAWorkstationCoreSetup.exe. Esse instalador exclui automaticamente a instalação destes componentes.

  • /remove_appdisk_ack

    Autoriza o instalador de VDA a desinstalar o plug-in AppDisks VDA se ele estiver instalado.

  • /remove_pvd_ack

    Autoriza o instalador de VDA a desinstalar o Personal vDisk se ele estiver instalado.

  • /remove

    Remove os componentes especificados com a opção /components.

  • /removeall

    Remove o VDA. Ele não remove o aplicativo Citrix Workspace (se instalado).

  • /sendexperiencemetrics

    Envia automaticamente análises coletadas durante a instalação, atualização ou remoção para a Citrix. Se esta opção for omitida (ou a opção /disableexperiencemetrics for especificada), as análises são coletadas localmente, mas não são enviadas automaticamente.

  • /servervdi

    Instala um VDA com SO de sessão única em um servidor Windows compatível. Omita esta opção quando instalar um VDA com SO multissessão em um servidor Windows. Antes de usar essa opção, consulte VDI do servidor.

  • /site_guid guid

    Identificador Globalmente Exclusivo da Unidade Organizacional (UO) do Active Directory do site. Associa uma área de trabalho virtual a um site quando você estiver usando o Active Directory para descoberta (a atualização automática é o método de descoberta recomendado e o padrão). O GUID do site é uma propriedade do site exibida em Manage > Full Configuration. Não especifique ambas as opções /site_guid e /controllers.

  • /tempdir diretório

    Diretório para manter os arquivos temporários durante a instalação. Padrão = c:\Windows\Temp.

    Esta opção não está disponível na interface gráfica.

  • /virtualmachine

    Válido somente ao instalar um VDA em uma VM. Substitui a detecção pelo instalador de uma máquina física, onde as informações do BIOS passadas para as VMs fazem com que elas apareçam como máquinas físicas.

    Esta opção não está disponível na interface gráfica.

  • /wem_add_firewall_rules

    Adiciona regras de firewall do agente WEM.

  • /wem_agent_cache_location

    Local alternativo do cache do agente WEM.

  • /wem_agent_port

    Porta que o agente WEM usa para se comunicar com o servidor de infraestrutura WEM.

  • /wem_cached_data_sync_port

    Porta que o agente WEM usa para sincronizar o cache com o servidor de infraestrutura WEM.

  • /wem_cloud_connectors

    Lista separada por vírgula dos Citrix Cloud Connectors no local do recurso que contém a implantação do WEM.

  • /wem_server

    FQDN ou endereço IP do servidor de infraestrutura WEM.

  • /xendesktopcloud

    Indica que o VDA está instalado em uma implantação do Citrix DaaS (Citrix Cloud).

Exemplos: instalar um VDA

O comando a seguir instala um VDA em um SO multissessão. O VDA será usado como uma imagem.

VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimage

O comando a seguir instala um Core Services VDA em um SO de sessão única para uso em um Remote PC Access ou implantação VDI. O aplicativo Citrix Workspace e outros serviços não principais não são instalados. O endereço de um Cloud Connector é especificado e as portas no Serviço do Firewall do Windows são abertas automaticamente. O administrador lida com as reinicializações.

VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot

Personalizar um VDA usando a linha de comando

Depois de instalar um VDA, você pode personalizar várias configurações. Execute XenDesktopVDASetup.exe usando uma ou mais das seguintes opções.

  • /reconfigure (necessário quando personalizar um VDA)
  • /h ou /help
  • /quiet
  • /noreboot
  • /controllers
  • /portnumber port
  • /enable_hdx_ports

O que fazer a seguir

Instalar VDAs usando a linha de comando