Instalar VDAs usando a linha de comando

Introdução

Instalar um VDA a partir da linha de comando

1. Na máquina onde você está instalando o VDA, faça login em Citrix Cloud.
2. No menu superior esquerdo, selecione Soluções > DaaS.
3. No lado superior direito, clique em Downloads e selecione Download VDA. Você será redirecionado para a página de download do VDA. Encontre o instalador do VDA que deseja e clique em Download File.
4. Após a conclusão do download, execute seu nome. Use as opções descritas neste artigo.
   • Para o Virtual Delivery Agent de SO multi-sessão, execute VDAServerSetup.exe
   • Para o Virtual Delivery Agent de SO de sessão única, execute VDAWorkstationSetup.exe
   • Para o Virtual Delivery Agent de Serviços Principais de SO de sessão única, execute VDAWorkstationCoreSetup.exe

• 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

• /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 é instalado (e não o aplicativo Citrix Workspace).
  Esta opção não é válida ao usar o instalador VDAWorkstationCoreSetup.exe. Esse instalador não pode instalar o aplicativo Citrix Workspace.
• /controllers "controlador ..."
  FQDNs de Citrix Cloud Connectors separados por espaço com os quais o VDA pode se comunicar, entre aspas retas. Não especifique as opções /site_guid e /controllers simultaneamente.
• /desabilitarmétricasdeexperiência
  Impede o upload 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 pelos 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 portas, consulte Portas de rede.
  Para abrir as portas UDP para o transporte adaptável HDX, especifique a opção /enable_hdx_udp_ports, além da opção /enable_hdx_ports.
• /enable_hdx_udp_ports
  Abre as 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 portas, consulte Portas de rede.
  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
  Habilita ou desabilita o uso de UDP para pacotes de áudio (Transporte de Áudio em Tempo Real para áudio). Habilitar esse recurso pode melhorar o desempenho do áudio. Inclua a opção /enable_hdx_ports se você 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 as funções de Monitoramento. Se você especificar esta 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) Habilita 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 não tenha sido usado.
  Para obter detalhes, consulte Restaurar em caso de falha na instalação ou atualização.
• /enable\_ss\_ports
  Abre as 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 ativado. Se você estiver usando um firewall diferente ou nenhum firewall, deverá configurar o firewall manualmente.
• /exclude "componente"\[,"componente"\]
  Impede a instalação de um ou mais componentes opcionais separados por vírgulas, cada um entre aspas retas. Por exemplo, a instalação ou atualização de um VDA em uma imagem gerenciada por MCS requer o componente Serviço de Identidade da Máquina. Os valores válidos são:
  • Serviço de Identidade da Máquina
  • Citrix Profile Management
  • Citrix Profile Management WMI Plug-in
  • Personalização Citrix para App-V - VDA
  • 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 solução de problemas de VDAs a partir do console Monitor. Nas páginas Detalhes do usuário e Ponto de extremidade, o painel Personalização e o painel Duração do Logon falham. Nas páginas Painel e Tendências, o painel Duração Média do Logon exibe dados apenas para máquinas que têm o Profile Management instalado.
  Mesmo que você esteja usando uma solução de Profile Management de terceiros, a Citrix recomenda que você instale e execute o Serviço Citrix Profile Management. A ativação do Serviço Citrix Profile Management não é obrigatória.
  Se você planeja usar o MCS para provisionar VMs, não exclua o Serviço de Identidade da Máquina.
  Se você especificar /exclude e /includeadditional com o mesmo nome de componente, o componente não será instalado.
  Esta opção não é válida ao usar o instalador VDAWorkstationCoreSetup.exe. Esse instalador exclui automaticamente muitos desses itens.
• /h ou /help
  Exibe a ajuda do comando.
• /includeadditional "componente"\[,"componente"\] ...
  Inclui a instalação de um ou mais componentes opcionais separados por vírgulas, cada um entre aspas simples. Os nomes dos componentes diferenciam maiúsculas de minúsculas.
  Esta opção pode ser útil ao criar uma implantação de Acesso Remoto a PC e desejar instalar componentes que não são incluídos por padrão. Os valores válidos são:
  • Citrix Profile Management
  • Citrix Profile Management WMI Plug-in
  • Citrix Personalização para App-V - VDA
  • Citrix MCS IODriver
  • Citrix VDA Upgrade Agent
  • Citrix Rendezvous V2
  • Camada de personalização do usuário
  • Citrix Web Socket VDA Registration Tool
  Se você especificar /exclude e /includeadditional com o mesmo nome de componente, esse componente não será 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
  Local 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.
• /imagem mestre
  Válido apenas 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 instalador VDAWorkstationCoreSetup.exe.
• /imagem mestre mcs
  Especifica que esta máquina será usada como uma imagem com o Machine Creation Services. Esta opção é equivalente a /masterimage.
• /imagem mestre pvs
  Especifica que esta 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 que 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 falhará. A maioria das edições do Windows suportadas já vem com o Media Foundation instalado, exceto as edições N.
• /semexperiênciadedesktop
  Válido apenas ao instalar um VDA de SO multi-sessão. Impede a habilitação do recurso Experiência de Área de Trabalho Aprimorada. Este recurso também é controlado pela configuração de política Citrix de Experiência de Área de Trabalho Aprimorada.
• /semreinicialização
  Impede uma reinicialização após a instalação. O VDA não pode ser usado antes de uma reinicialização.
• /semretomar
  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úmerodaporta porta
  Válido apenas quando a opção /reconfig é especificada. Número da porta a ser habilitada para comunicações entre o VDA e o Controller. A porta configurada anteriormente é desabilitada, a menos que seja a porta 80.
• /configuraçãodoproxy "endereço ou caminho do arquivo PAC"
  Válido apenas se o comando contiver /includeadditional "Citrix Rendezvous V2". O endereço ou caminho do arquivo PAC do proxy para uso com o protocolo Rendezvous. Para detalhes do recurso, consulte protocolo Rendezvous.
  • Formato do endereço do proxy: http://<url-or-ip>:<port>
  • Formato do 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.
• /reconfigurar
  Personaliza as configurações do VDA configuradas anteriormente quando usado 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 será iniciada.
• /pcremoto
  Válido apenas para implantações de Acesso Remoto a PC (SO de sessão única) ou conexões intermediadas (SO de múltiplas sessões).
  Esta opção não é válida ao usar o instalador VDAWorkstationCoreSetup.exe. Esse instalador exclui automaticamente a instalação desses componentes.
• /remove_appdisk_ack
  Autoriza o instalador do VDA a desinstalar o plug-in AppDisks™ VDA, se estiver instalado.
• /remove_pvd_ack
  Autoriza o instalador do VDA a desinstalar o Personal vDisk, se estiver instalado.
• /remover
  Remove os componentes especificados com a opção /components.
• /removertudo
  Remove o VDA. Não remove o aplicativo Citrix Workspace (se instalado).
• /enviarmetricasdeexperiencia
  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.
• servidorvdi
  Instala um VDA de SO de sessão única em um servidor Windows compatível. Omita esta opção ao instalar um VDA de várias sessões em um servidor Windows. Antes de usar esta opção, consulte Server VDI.
• local_guid guid
  Identificador Globalmente Único da Unidade Organizacional (OU) 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 as opções /site_guid e /controllers.
• dirtemp diretório
  Diretório para armazenar arquivos temporários durante a instalação. Padrão = c:\Windows\Temp.
  Esta opção não está disponível na interface gráfica.
• máquinavirtual
  Válido apenas 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 as fazem parecer máquinas físicas.
  Esta opção não está disponível na interface gráfica.
• xendesktopnuvem
  Indica que o VDA está instalado em uma implantação do Citrix DaaS (Citrix Cloud™).

Exemplos: Instalar um VDA

• Instalar um VDA em um SO de várias sessões. O comando a seguir instala um VDA em um SO de várias sessões.
  VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimage
  O VDA será usado como uma imagem.
• Instalar um VDA de SO multi-sessão ou VDA de SO de sessão única. O comando a seguir instala um VDA de SO multi-sessão ou um VDA de SO 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 delivery controller™ por uma vírgula. Observe que XXXX representa a versão do VDA.
• Instalar um VDA de Serviços Essenciais em um SO de sessão única. O comando a seguir instala um VDA de Serviços Essenciais em um SO de sessão única para uso em um acesso remoto de PC ou implantação de 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 sã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 as reinicializações.

Personalizar um VDA usando a linha de comando

• /reconfigure (obrigatório ao personalizar um VDA)
• /h ou /help
• /quiet
• /noreboot
• /controllers
• /portnumber port
• /enable_hdx_ports

Onde ir em seguida

• Criar catálogos de máquinas
• Para revisar todo o processo de configuração, consulte Planejar e construir uma implantação.