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, revise Instalar VDAs para saber mais sobre 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 retornados), você deve ter permissões administrativas elevadas ou usar Executar como administrador.

  1. Na máquina em que você está instalando o VDA, assine para Nuvem Citrix.
  2. No menu superior esquerdo, selecione Meus serviços > DaaS.
  3. No canto superior direito, clique em Downloads e selecione Baixar VDA. Você é redirecionado para o Página de download do VDA. Encontre o instalador do VDA desejado e clique em Baixar arquivo.
  4. Após a conclusão do download, execute seu nome. Use as opções descritas neste artigo.

    • Para o agente de entrega virtual do sistema operacional de várias sessões, execute VDAServerSetup.exe

    • Para o agente de entrega virtual do sistema operacional de sessão única, execute VDAWorkstationSetup.exe

    • Para o Agente de Entrega Virtual de Serviços Principais do SO de sessão única, execute VDAWorkstationCoreSetup.exe

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

  • Durante VDAServerSetup_XXXX.execorrer <extract folder>\Extrair\Imagem-Cheia\x64\XeConfiguração do nDesktop\XenDesktopVDASetup.exe

  • Durante VDAWorkstationCoreSetup_XXXX.execorrer <extract folder>\Extrair\Imagem-Cheia\x64\XeConfiguração do nDesktop\XenDesktopRemotePCSetup.exe

  • Durante VDAWorkstationSetup_XXXX.execorrer <extract folder>\Extrair\Imagem-Cheia\x64\XeConfiguração do nDesktop\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.exee VDAWorkstationCoreSetup.exe.

  • /Componentes componente[,componente]

    Lista separada por vírgulas de componentes a serem instalados ou removidos. Os valores válidos são:

    • VDA: Agente de entrega virtual

    • PLUGINS: Aplicativo Citrix Workspace para Windows

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

    Se o Plugins for deixada de fora, somente o VDA será instalado (não o aplicativo Citrix Workspace).

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

  • /Controladorescontrolador [controlador]…”

    FQDNs separados por espaço do Citrix Cloud Connectors com os quais o VDA pode se comunicar, entre aspas retas. Não especifique o /site_guid e /Controladores Opções.

  • /desativarexperiênciamétricas

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

  • /enable_hdx_ports

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

    Para abrir as portas UDP que o transporte adaptável HDX, especifique o /enable_hdx_udp_ports opção, além da opção /enable_hdx_ports opção.

  • /enable_hdx_udp_ports

    Abre portas UDP no firewall do Windows que o transporte adaptável HDX exige, se o Serviço de Firewall do Windows for detectado, mesmo que o firewall não esteja habilitado. Se você estiver usando um firewall diferente ou nenhum firewall, deverá configurar o firewall manualmente. Para obter informações sobre a porta, consulte Portas de rede.

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

  • /enable_real_time_transport

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

  • /enable_remote_assistance

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

  • /enablerestore ou /enablerestorecleanup

    (Válido apenas 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 êxito:

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

    Para obter detalhes, consulte Restauração em caso de falha na 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 você estiver usando um firewall diferente ou nenhum firewall, deverá configurar o firewall manualmente.

  • /excluircomponente”[,”componente”]

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

    • Serviço de Identidade de Máquina
    • Gerenciamento de perfis Citrix
    • Citrix Profile Management WMI Plug-in
    • Citrix Personalization for App-V - VDA
    • Citrix MCS IODriver
    • Agente de atualização do Citrix VDA
    • Citrix Rendezvous V2

    Excluindo o Citrix Profile Management da instalação (/exclude "Citrix Profile Management") afeta o monitoramento e a solução de problemas de VDAs do Monitor consolar. No Detalhes do usuário e Extremidade , o painel Personalização e o painel Duração do logon falharão. No Painel e Tendências , o painel Duração média do logon exibirá dados somente para máquinas que têm o Gerenciamento de perfis instalado.

    Mesmo se você estiver usando uma solução de gerenciamento de perfil de terceiros, a Citrix recomenda que você instale e execute o Citrix Profile Management Service. Não é necessário ativar o Citrix Profile Management Service.

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

    Se você especificar ambos /excluir e /includeadicional Com o mesmo nome de componente, o componente não é instalado.

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

  • /h ou /Ajuda

    Exibe a ajuda do comando.

  • /includeadicionalcomponente”[,”componente”] …

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

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

    • Gerenciamento de perfis Citrix
    • Citrix Profile Management WMI Plug-in
    • Citrix Personalization for App-V - VDA
    • Citrix MCS IODriver
    • Agente de atualização do Citrix VDA
    • Citrix Rendezvous V2
    • Camada de personalização do usuário
    • Ferramenta de registro Citrix Web Socket VDA

    Se você especificar ambos /excluir e /includeadicional com o mesmo nome de componente, esse componente não está instalado.

  • /installdir diretório

    Diretório vazio existente onde os componentes serão instalados. Padrão = c:\Arquivos de Programas\Citrix.

  • /install_mcsio_driver

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

  • /logpath caminho

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

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

  • /imagem mestra

    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 ao usar o VDAWorkstationCoreSetup.exe Instalador.

  • /mastermcsimage

    Especifica que essa máquina será usada como uma imagem com os Serviços de Criação de Máquina. Esta opção é equivalente a /imagem mestra.

  • /masterpvsimage

    Especifica que essa máquina será usada como uma imagem com o Citrix Provisioning ou 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 essa opção for omitida e o Media Foundation não estiver instalado, a instalação do VDA falhará. A maioria das edições do Windows com suporte vem com o Media Foundation já instalado, exceto as edições N.

  • /nodesktopexperience

    Válido somente ao instalar um VDA de SO de várias sessões. Impede a ativação do recurso Experiência de Área de Trabalho Aprimorada. Esse recurso também é controlado com a configuração de política Citrix Enhanced Desktop Experience.

  • /noreboot

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

  • /noresume

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

  • /número da porta porta

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

  • /proxyconfigendereço ou caminho do arquivo PAC

    Válido somente se o comando contiver /includeadicional "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 de encontro.

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

    Nenhuma interface do 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 essa opção for omitida, a interface gráfica será iniciada.

  • /Reconfigurar

    Personaliza as configurações de VDA configuradas anteriormente quando usado com o /número da porta, /Controladoresou /enable_hdx_ports Opções. Se você especificar essa opção sem especificar também o /quieto , a interface gráfica para personalizar os lançamentos do VDA.

  • /remotepc

    Válido apenas para implantações de Acesso ao PC Remoto (sistema operacional de sessão única) ou conexões agenciadas (sistema operacional de várias sessões).

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

  • /remove_appdisk_ack

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

  • /remove_pvd_ack

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

  • /retirar

    Remove os componentes especificados com o /Componentes opção.

  • /remover tudo

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

  • /sendexperiencemetrics

    Envia automaticamente as análises coletadas durante a instalação, atualização ou remoção para a Citrix. Se essa opção for omitida (ou o /desativarexperiênciamétricas for especificada), as análises serão coletadas localmente, mas não enviadas automaticamente.

  • /servervdi

    Instala um VDA de SO de sessão única em um servidor Windows compatível. Omita essa opção ao instalar um VDA de várias sessões 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. Isso associa uma área de trabalho virtual a um site quando você está usando o Active Directory para descoberta (a atualização automática é o método de descoberta recomendado e padrão). O GUID do site é uma propriedade do site exibida no Studio. Não especifique o /site_guid e /Controladores Opções.

  • /tempdir diretório

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

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

  • /máquina virtual

    Válido somente ao instalar um VDA em uma VM. Substitui a detecção pelo instalador de uma máquina física, em que 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.

  • /xendesktopcloud

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

Exemplos: Instalar um VDA

  • Instale um VDA em um sistema operacional de várias sessões. O comando a seguir instala um VDA em um sistema operacional de várias sessões.

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

    O VDA será usado como uma imagem.

  • Instale um VDA de SO de várias sessões ou um VDA de SO de sessão única. O comando a seguir instala um VDA do sistema operacional de várias sessões ou um VDA do sistema operacional de sessão única.

    VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /noreboot

    Separe cada FQDN do controlador de entrega por uma vírgula. Observe que XXXX representa a versão do VDA.

  • Instale um VDA de serviços principais em um sistema operacional de sessão única. O comando a seguir instala um VDA de serviços principais em um sistema operacional de sessão única para uso em uma implantação de acesso remoto ao PC ou VDA.

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

    O aplicativo Citrix Workspace e outros serviços não essenciais não estão instalados. O endereço de um Cloud Connector é especificado e as portas no Serviço de Firewall do Windows são abertas automaticamente. O administrador lida com reinicializações.

Personalizar um VDA usando a linha de comando

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

  • /Reconfigurar (necessário ao personalizar um VDA)
  • /h or /help
  • /quiet
  • /noreboot
  • /controllers
  • /portnumber port
  • /enable_hdx_ports

Para onde ir a seguir

Instalar VDAs usando a linha de comando