Instalar usando a linha de comando

Introdução

Usar o instalador completo do produto

1. Baixe o pacote do produto da Citrix. As credenciais da conta Citrix são necessárias para acessar o site de download.
2. Descompacte o arquivo. Opcionalmente, grave um DVD do arquivo ISO.
3. Faça logon no servidor onde você está instalando os componentes, usando uma conta de administrador local.
4. Insira o DVD na unidade ou monte o arquivo ISO.
5. No diretório \x64\XenDesktop Setup da mídia, execute o comando apropriado.
   Para instalar componentes principais: Execute XenDesktopServerSetup.exe, com as opções listadas em Opções de linha de comando para instalar componentes principais.
   Para instalar um VDA: Execute XenDesktopVDASetup.exe com as opções listadas em Opções de linha de comando para instalar um VDA.
   Para instalar o StoreFront: Execute CitrixStoreFront-x64.exe na pasta x64 > StoreFront na mídia de instalação.
   Para instalar o Universal Print Server: Siga as orientações em Opções de linha de comando para instalar um Universal Print Server.
   Para instalar o Federated Authentication Service: A Citrix recomenda usar a interface gráfica.
   Para instalar o Session Recording: Siga as orientações em Session Recording.

Opções de linha de comando para instalar componentes principais

• /components componente ...
  Lista de componentes separados por vírgula para instalar ou remover. Os valores válidos são:
  • CONTROLLER: Controller
  • DESKTOPSTUDIO: Studio
  • DESKTOPDIRECTOR: Director
  • LICENSESERVER: Citrix License Server
  Se esta opção for omitida, todos os componentes são instalados (ou removidos, se a opção /remove também for especificada).
  (Em versões anteriores a 2003, os valores válidos incluíam STOREFRONT. Para a versão 2003 e posterior, use o comando de instalação dedicado do StoreFront mencionado em Usar o instalador completo do produto).
• /configure_firewall
  Abre todas as portas no firewall do Windows usadas pelos componentes que estão sendo instalados, se o Serviço de Firewall do Windows estiver em execução, mesmo que o firewall não esteja habilitado. Se você estiver usando um firewall de terceiros ou nenhum firewall, deverá abrir as portas manualmente.
• /desabilitarmétricasdeexperiência
  Impede o upload automático de análises coletadas durante a instalação, atualização ou remoção para a Citrix.
• /help ou /h
  Exibe a ajuda do comando.
• /ignore\_hw\_check\_failure
  Permite que a instalação ou atualização do Delivery Controller continue, mesmo que as verificações de hardware falhem (por exemplo, devido a RAM insuficiente). Para obter mais informações, consulte Verificação de hardware.
• /ignore\_site\_test\_failure
  Válido apenas durante a atualização do Controller. Geralmente, quaisquer falhas de teste de site são ignoradas e a atualização prossegue. Se omitido (ou definido como falso), qualquer falha de teste de site faz com que o instalador falhe, sem realizar a atualização. Padrão = falso
  Durante uma atualização, esta opção é ignorada se uma versão não suportada do SQL Server for detectada. Para obter detalhes, consulte Verificação da versão do SQL Server.
• /installdir diretório
  Diretório vazio existente onde os componentes serão instalados. Padrão = c:\Program Files\Citrix.
• /logpath caminho
  Local do arquivo de log. A pasta especificada deve existir. O instalador não a cria. Padrão = TEMP%\Citrix\XenDesktop Installer
• /no_pending_reboot_check
  Ao instalar ou atualizar componentes principais, impede a verificação de uma reinicialização pendente de uma instalação anterior do Windows na máquina.
• /no_remote_assistance
  Válido apenas ao instalar o Director. Desativa o recurso de sombreamento de usuário que usa a Assistência Remota do Windows.
• /semreinicialização
  Impede uma reinicialização após a instalação. (Para a maioria dos componentes principais, uma reinicialização não é habilitada por padrã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.
• /sem-sql
  Impede a instalação do Microsoft SQL Server Express no servidor onde você está instalando o Controller. Se esta opção for omitida, o SQL Server Express é instalado para ser usado como o banco de dados do site.
  Esta opção não tem efeito na instalação do SQL Server Express LocalDB usado para o Cache do Host Local.
• /quiet ou /passive
  Nenhuma interface de usuário aparece durante a instalação. A única evidência do processo de instalação está no Gerenciador de Tarefas do Windows. Se esta opção for omitida, a interface gráfica é iniciada.
• /remover
  Remove os componentes principais especificados com a opção /components.
• /removertudo
  Remove todos os componentes principais instalados.
• /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 /disableexperiencemetrics for especificado), as análises são coletadas localmente, mas não são enviadas automaticamente.
• dirtemp diretório
  Diretório que armazena arquivos temporários durante a instalação. Padrão = c:\Windows\Temp.
• /XenApp
  Instala o Citrix Virtual Apps. Se esta opção for omitida, o Citrix Virtual Apps and Desktops™ será instalado.

Exemplos de instalação de componentes principais

Usar um instalador VDA autônomo

1. Baixe o pacote apropriado da Citrix:
   • Virtual Delivery Agent de SO multissessão: VDAServerSetup.exe
   • Virtual Delivery Agent de SO de sessão única: VDAWorkstationSetup.exe
   • Virtual Delivery Agent de Serviços Principais de SO de sessão única: VDAWorkstationCoreSetup.exe
2. Primeiro, extraia os arquivos do pacote para um diretório existente e, em seguida, execute o comando de instalação, ou simplesmente execute o pacote.
   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. 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.
   • 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
   Para executar o pacote baixado, execute seu nome: VDAServerSetup.exe, VDAWorkstationSetup.exe ou VDAWorkstationCoreSetup.exe. Use as opções válidas listadas neste artigo.

• Execute o instalador autônomo VDAServerSetup.exe ou VDAWorkstationSetup.exe como se fosse o comando XenDesktopVdaSetup.exe em tudo, exceto no seu nome.
• O instalador VDAWorkstationCoreSetup.exe é diferente, porque suporta um subconjunto das opções disponíveis para os outros instaladores.

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: Agente de Entrega Virtual
  • PLUGINS: aplicativo Citrix Workspace™ para Windows
  Para instalar o VDA e o aplicativo Citrix Workspace para Windows, especifique /components vda,plugins.
  Se esta opção for omitida, apenas o VDA será instalado (não o aplicativo Citrix Workspace).
  Esta opção não é válida ao usar o instalador VDAWorkstationCoreSetup_xxxx.exe. Esse instalador não pode instalar o aplicativo Citrix Workspace.
• /controllers "controlador \[controlador\]"
  FQDNs de Controladores 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.
• /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 que o transporte adaptativo HDX usa, especifique a opção /enable_hdx_udp_ports, além desta opção /enable_hdx_ports.
• /enable\_hdx\_udp\_ports
  Abre as portas UDP no firewall do Windows que o transporte adaptativo HDX usa, 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. Para obter informações sobre portas, consulte Portas de rede.
  Para abrir portas extras que o VDA usa, especifique a opção /enable_hdx_ports, além desta 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 no Assistência Remota do Windows para uso com o Director. Se você especificar esta opção, o 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 reter 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, instalar ou atualizar um VDA em uma imagem que não é gerenciada pelo MCS não requer o componente Machine Identity Service. Os valores válidos são os seguintes:

  SO multissessão	SO de sessão única	Serviços Principais do SO de Sessão Única
  Citrix Authentication Identity Assertion VDA Plug-in	Citrix Authentication Identity Assertion VDA Plug-in	Citrix Authentication Identity Assertion VDA Plug-in
  Citrix Backup and Restore	Citrix Backup and Restore	Citrix Browser Content Redirection
  Citrix Browser Content Redirection	Citrix Browser Content Redirection	Citrix Personalization for App-V - VDA
  Citrix MCS IODriver	Citrix MCS IODriver	Citrix Telemetry Service
  Citrix Personalization for App-V - VDA	Citrix Personalization for App-V - VDA	Citrix Universal Print Client
  Citrix Profile Management	Citrix Profile Management	Citrix Vda Log Capture Service
  Citrix Profile Management WMI Plug-in	Citrix Profile Management WMI Plug-in	CSE Component
  Citrix Rendezvous V2	Citrix Rendezvous V2	Director VDA Plug-in
  Citrix Supportability Tools	Citrix Supportability Tools	Machine Management Provider
  Citrix Telemetry Service	Citrix Telemetry Service	VDA Monitor Plug-in
  Citrix Universal Print Client	Citrix Universal Print Client	VDA WMI Proxy Plug-in
  Citrix Vda Log Capture Service	Citrix Vda Log Capture Service
  Citrix VDA Upgrade Agent	Citrix VDA Upgrade Agent
  Citrix WEM Agent	Citrix WEM Agent
  CSE Component	CSE Component
  Director VDA Plug-in	Director VDA Plug-in
  Machine Identity Service	Machine Identity Service
  Machine Management Provider	Machine Management Provider
  VDA Monitor Plug-in	User Personalization Layer
  VDA WMI Proxy Plug-in	VDA Monitor Plug-in
  	VDA WMI Proxy Plug-in

  Excluir o Citrix Profile Management da instalação (/exclude "Citrix Profile Management") afeta o monitoramento e a solução de problemas de VDAs com o Citrix Director. Nas páginas Detalhes do usuário e EndPoint, 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 gerenciamento de perfil de usuário de terceiros, a Citrix recomenda que você instale e execute o Serviço de Gerenciamento de Perfil da Citrix. A habilitação do Serviço de Gerenciamento de Perfil da Citrix não é obrigatória.
  Se você especificar /exclude e /includeadditional com o mesmo nome de componente, esse 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.
• /incluiradicional "componente"\[,"componente"\]
  Inclui a instalação de um ou mais componentes opcionais separados por vírgulas, cada um entre aspas retas. Esta opção pode ser útil ao criar uma implantação de Acesso Remoto para PC e desejar instalar outros componentes que não estão incluídos por padrão. Os valores válidos são os seguintes:

  SO multissessão	SO de sessão única
  Citrix Backup and Restore	Citrix Backup and Restore
  Citrix MCS IODriver	Citrix MCS IODriver
  Citrix Personalization for App-V - VDA	Citrix Personalization for App-V - VDA
  Citrix Profile Management	Citrix Profile Management
  Citrix Profile Management WMI Plug-in	Citrix Profile Management WMI Plug-in
  Citrix Rendezvous V2	Citrix Rendezvous V2
  Citrix Supportability Tools	Citrix Supportability Tools
  Citrix VDA Upgrade Agent	Citrix VDA Upgrade Agent
  Citrix WEM Agent	Citrix WEM Agent
  Machine Identity Service	Machine Identity Service
  	User Personalization Layer

  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 a ser usada para criar outras máquinas. Esta opção é equivalente a /mastermcsimage.
  Esta opção não é válida ao usar o instalador VDAWorkstationCoreSetup_xxxx.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 Citrix Provisioning™ ou uma ferramenta de provisionamento de terceiros (como Microsoft System Center Configuration Manager) para provisionar VMs.
• /no\_mediafoundation\_ack
  Reconhece que o Microsoft Media Foundation não está instalado e que vários recursos multimídia HDX™ não serão instalados e não funcionarão. 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 compatíveis do Windows já vem com o Media Foundation instalado, exceto as edições N.
• /semexperiênciadedesktop
  O recurso Enhanced Desktop Experience não está mais disponível. Esta opção (e configuração de política) é ignorada, se especificada.
  Válido apenas ao instalar um VDA para 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.
• /proxyconfig “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 multi-sessão). Exclui a instalação de quaisquer componentes adicionais (consulte as listas de componentes com as opções /exclude e /includeadditional).
  Esta opção não é válida ao usar o instalador VDAWorkstationCoreSetup.exe. Esse instalador exclui automaticamente a instalação desses componentes.
  /remotepc não é compatível com a opção /servervdi.
• /remover
  Remove os componentes especificados com a opção /components.
• /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.
• /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 para SO de sessão única em uma máquina Windows multi-sessão compatível. Omita esta opção ao instalar um VDA para SO multi-sessão em uma máquina Windows multi-sessão.
  Antes de usar esta opção, consulte Server VDI.
  Use esta opção apenas com o instalador VDA de produto completo.
• 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.
• /wem_add_firewall_rules
  Adiciona regras de firewall do agente WEM.
• /wem_agent_cache_location
  Localização alternativa 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írgulas de Citrix Cloud™ Connectors no local do recurso que contém a implantação WEM.
• /wem_server
  FQDN ou endereço IP do servidor de infraestrutura WEM.
• xendesktopnuvem
  Indica que o VDA está instalado em uma implantação do Citrix DaaS™ (Citrix Cloud).

Exemplos de instalação de um VDA

Personalizar um VDA

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

Solucionar problemas de VDAs

• Na exibição do Studio para um grupo de entrega, a entrada Versão do VDA instalada no painel Detalhes pode não ser a versão instalada nas máquinas. A exibição Programas e Recursos do Windows da máquina mostra a versão real do VDA.
• Depois que um VDA é instalado, ele não pode entregar aplicativos ou um desktop aos usuários até que se registre em um Delivery Controller.
  Para saber mais sobre os métodos de registro de VDA e como solucionar problemas de registro, consulte Registro de VDA.

Opções de linha de comando para instalar um Universal Print Server

• /enable_upsserver_port

Mais informações