Citrix Virtual Apps and Desktops

Instalar usando a linha de comando

Importante:

  • Se você estiver atualizando e sua versão atual usa ou tiver o software Personal vDisk ou AppDisks instalado, consulte Remover PvD, AppDisks e hosts não suportados.

  • A Citrix coleta dados básicos de licenciamento conforme necessário para seus interesses legítimos, incluindo conformidade de licenciamento. Para obter mais informações, consulte Citrix Licensing Data.

Introdução

Este artigo aplica-se à instalação de componentes em máquinas com sistemas operacionais Windows. Para obter informações sobre sistemas operacionais VDAs para Linux, consulte Linux Virtual Delivery Agents.

Este artigo descreve como emitir comandos de instalação de produto. Antes de iniciar qualquer instalação, revise Preparar a instalação. Este artigo inclui descrições dos instaladores disponíveis.

Para ver o progresso da execução do comando e os valores de retorno, você deve ser o administrador original ou usar a opção Executar como administrador. Para obter mais informações, consulte a documentação sobre comandos da Microsoft.

Como complemento ao uso dos comandos de instalação diretamente, são fornecidos scripts de exemplo no ISO do produto que instalam, atualizam ou removem VDAs em máquinas no Active Directory. Para obter detalhes, consulte Instalar VDAs usando scripts.

Se você tentar instalar ou atualizar em uma versão do sistema operacional Windows que não é compatível com esta versão do Citrix Virtual Apps and Desktops, uma mensagem lhe fornecerá informações sobre suas opções. Veja Sistemas operacionais anteriores.

Para obter informações sobre como a Citrix reporta o resultado de instalações de componentes, consulte Códigos de retorno da instalação Citrix.

Usar o instalador de produto completo

Para acessar a interface da linha de comando do instalador do produto completo:

  1. Baixe o pacote de produtos da Citrix. As credenciais da conta da 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 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 na 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 Serviço de autenticação federada: a Citrix recomenda o uso da interface gráfica.

    Para instalar o Session Recording: siga as orientações em Session Recording.

    Para instalar o Workspace Environment Management: siga as orientações em Workspace Environment Management.

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

As seguintes opções de parâmetros são válidas ao instalar componentes principais com o comando XenDesktopServerSetup.exe. Para obter mais detalhes sobre as opções, consulte Instalar componentes principais.

  • /ceipoptin ceipoptin [,*ceipoptin*] …

    Permite a coleta de dados do Call Home e do Programa de Aperfeiçoamento da Experiência do Usuário (CEIP). Os valores válidos são:

    • DIAGNOSTIC: escolha esse valor para permitir que o Citrix Licensing colete dados do Call Home.
    • ANONYMOUS: escolha esse valor para permitir que o Citrix Licensing colete dados CEIP não identificados (que não identificam usuários).
    • NONE: escolha esse valor para desativar a coleção de dados do CEIP pelo Citrix Licensing.

    Para obter mais informações sobre a coleta de dados do Call Home, consulte Citrix Licensing Call Home.

    Para obter mais detalhes sobre a coleta de dados do CEIP, consulte o Programa de Aperfeiçoamento da Experiência do Usuário do Citrix Licensing.

    Para obter mais detalhes sobre os dados do CEIP, consulte Elementos de dados do Citrix Licensing CEIP.

    Para obter mais detalhes sobre os dados de licenciamento do servidor de licenças, consulte os Dados do Citrix Licensing.

  • /components componente [,*componente*] …

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

    • CONTROLLER: Controller
    • DESKTOPSTUDIO: Studio
    • WEBSTUDIO: Web Studio
    • DESKTOPDIRECTOR: Director
    • LICENSESERVER: Citrix License Server

    Se esta opção for omitida, todos os componentes serão instalados (ou removidos, se a opção /remove também for especificada).

    (Nas 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 do Firewall do Windows estiver em execução, mesmo que o firewall não esteja ativado. Se você estiver usando um firewall de terceiros, ou se não estiver usando nenhum firewall, deverá abrir as portas manualmente.

  • /disableexperiencemetrics

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

  • /excluderecurso”[,”recurso”]

    Impede a instalação de um ou mais recursos, serviços ou tecnologias separados por vírgula, cada qual entre aspas retas normais. Os valores válidos são:

    • "Local Host Cache Storage (LocalDB)": impede a instalação do banco de dados usado para o Cache de host local. Esta opção não afeta se a instalação do SQL Server Express é realizada para usar como banco de dados do site ou não.
  • /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 à RAM insuficiente). Para obter mais informações, consulte Verificação de hardware.

  • /ignore_site_test_failure

    Válido somente durante a atualização do Controller. Normalmente, as falhas de teste do site são ignoradas e a atualização prossegue. Se omitido (ou definido como false), qualquer falha de teste do site faz com que o instalador falhe, sem executar a atualização. Padrão = false

    Durante uma atualização, esta opção é ignorada se uma versão do SQL Server não suportada for detectada. Para obter detalhes, consulte Verificação de 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

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

  • /no_remote_assistance

    Válido somente ao instalar o Director. Desativa o recurso de sombreamento de usuário que usa a Assistência Remota do Windows.

  • /noreboot

    Impede uma reinicialização após a instalação. (Para a maioria dos componentes principais, a reinicialização não é ativada por padrão.)

  • /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.

  • /nosql

    Impede a instalação do Microsoft SQL Server Express no servidor em que você está instalando o Controller. Se esta opção for omitida, o SQL Server Express é instalado para uso 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 de 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 será iniciada.

  • /remove

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

  • /removeall

    Remove todos os componentes principais instalados.

  • /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 /disableexperiencemetrics for especificada), as análises são coletadas localmente, mas não são enviadas automaticamente.

  • /tempdir diretório

    Diretório que mantém os 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

O comando a seguir instala um Delivery Controller, Studio, Citrix Licensing e SQL Server Express em um servidor. As portas de firewall necessárias para comunicações de componentes são abertas automaticamente.

\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall

O comando a seguir instala um Citrix Virtual Apps Controller, Studio e SQL Server Express no servidor. As portas de firewall necessárias para a comunicação de componentes são abertas automaticamente.

\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall

Usar um instalador autônomo de VDA

As credenciais da conta da Citrix são necessárias para acessar o site de download. Você deve ter privilégios administrativos elevados antes de iniciar a instalação ou usar Executar como administrador.

  1. Baixe o pacote apropriado da Citrix:
    • Virtual Delivery Agent de SO multissessão: VDAServerSetup_xxxx.exe
    • Virtual Delivery Agent de SO de sessão única: VDAWorkstationSetup_xxxx.exe
    • Virtual Delivery Agent de serviços principais de SO de sessão única: VDAWorkstationCoreSetup_xxxx.exe
  2. Extraia os arquivos do pacote para um diretório existente primeiro 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, C:\YourExtractFolder\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. O diretório deve existir. Caso contrário, a extração 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

    Para executar o pacote baixado, execute o seu nome: VDAServerSetup.exe, VDAWorkstationSetup.exe ou VDAWorkstationCoreSetup.exe. Use as opções válidas listadas neste artigo.

Se você estiver familiarizado com o instalador do produto completo:

  • Execute o instalador autônomo VDAServerSetup.exe ou VDAWorkstationSetup.exe como se fosse o comando XenDesktopVdaSetup.exe em tudo, exceto em 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

As seguintes opções são válidas com um ou mais dos seguintes comandos (instaladores): VDAServerSetup_xxxx.exe, VDAWorkstationSetup_xxxx.exe e VDAWorkstationCoreSetup_xxxx.exe.

Para obter mais detalhes sobre as opções, consulte Instalar VDAs.

  • /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 aplicativo Citrix Workspace para Windows, especifique /components vda,plugins.

    Se esta opção 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_xxxx.exe. Esse instalador não pode instalar o aplicativo Citrix Workspace.

  • /controllerscontroller [controller]”

    FQDNs separados por espaço de Controllers 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 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 portas UDP no firewall do Windows que o transporte adaptativo HDX usa, 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 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

    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

    Ativa o recurso de sombreamento na Assistência Remota do Windows para uso com o Director. 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 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 de 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 Telemetry Service Citrix Telemetry Service Machine Management Provider
    Citrix Universal Print Client Citrix Universal Print Client VDA Monitor Plug-in
    Citrix Vda Log Capture Service Citrix Vda Log Capture Service VDA WMI Proxy Plug-in
    Citrix VDA Upgrade Agent Citrix VDA Upgrade 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 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 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 de gerenciamento de perfil de usuário 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ê 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. Esta opção é útil quando você estiver criando uma implantação do Remote PC Access e quiser 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 VDA Upgrade Agent Citrix VDA Upgrade Agent
    Citrix Web Socket Vda Registration Tool Citrix Web Socket Vda Registration Tool
    Machine Identity Service Machine Identity Service
      User Personalization Layer

    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 para ser usada para criar outras máquinas. Esta opção é equivalente a /mastermcsimage.

    Esta opção não é válida quando usar o instalador VDAWorkstationCoreSetup_xxxx.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) para provisionar VMs.

  • /no_mediafoundation_ack

    Reconhece que o Microsoft Media Foundation não está instalado, e vários recursos multimídia HDX não serão instalados e não funcionarão. Se essa opção for omitida e o Media Foundation não estiver instalado, a instalação do VDA será encerrada, pois as pré-condições não foram atendidas. A maioria das edições compatíveis do Windows vem com o Media Foundation já instalado, exceto as edições N. Se você ativar Recursos do Windows > Recursos de mídia manualmente, a chave de registro procurada pelo Citrix Meta Installer pode não ter um valor definido. Verifique a chave de registro SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersion antes de iniciar o processo de instalação para confirmar se o valor existe e não está vazio.

  • /nodesktopexperience

    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 somente ao instalar um VDA de 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.

  • /physicalmachine

    Use esse argumento juntamente com /remotepc para a instalação do RemotePC. Caso contrário, o VDA pode não se comportar conforme o esperado em determinados cenários do usuário.

  • /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). 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 quando usar o instalador VDAWorkstationCoreSetup.exe. Esse instalador exclui automaticamente a instalação destes componentes.

    /remotepc não é compatível com a opção /servervdi.

  • /remove

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

  • /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.

  • /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 de SO de sessão única em uma máquina multissessão Windows suportada. Omita esta opção quando instalar um VDA de SO multissessão em uma máquina multissessão Windows.

    Antes de usar essa opção, consulte VDI do servidor.

    Use esta opção somente com o instalador de VDA de produto completo.

  • /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 no Studio. 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.

  • /xendesktopcloud

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

Exemplos de instalação de um VDA

Instalar um VDA com o instalador de produto completo:

O comando a seguir instala um VDA de SO de sessão única e o aplicativo Citrix Workspace no local padrão em uma VM. Este VDA será usado como uma imagem e usa o MCS para provisionar VMs. O VDA se registrará inicialmente no Controller no servidor com o nome Contr-Main no domínio mydomain. O VDA usará a camada de personalização do usuário e a Assistência Remota do Windows.

\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "user personalization layer" /mastermcsimage /enable_remote_assistance

Instale um VDA de SO de sessão única com o instalador autônomo VDAWorkstationCoreSetup:

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 Controller é especificado e as portas no Serviço do Firewall do Windows serão abertas automaticamente. O administrador lidará com as reinicializações.

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

Personalizar um VDA

Depois de instalar um VDA, você pode personalizar várias configurações. No \x64\XenDesktop Setup diretório na mídia do produto, execute XenDesktopVdaSetup.exe, usando uma ou mais das seguintes opções, descritas em opções de linha de comando para instalar um VDA.

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

Solucionar problemas de VDAs

  • Na tela do Studio de um grupo de entrega, a entrada Installed VDA version no painel Details pode não refletir a versão instalada nas máquinas. A exibição de 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 uma área de trabalho 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 Servidor de Impressão Universal

A seguinte opção é válida com o comando XenDesktopPrintServerSetup.exe.

  • /enable_upsserver_port
Software Pasta Nome do arquivo
Microsoft Visual C++ 2017 Runtime, 32 bits e 64 bits Support > VcRedist_2017 vcredist_x64.exe e vcredist_x86.exe
Citrix Diagnostic Facility x64 > Virtual Desktop Components cdf_x64.msi
Componente de servidor Universal Print Server x64 > Universal Print Server UpsServer_x64.msi

Quando esta opção não for especificada, o instalador exibe a página de Firewall a partir da interface gráfica. Selecione Automatically para que o instalador adicione automaticamente as regras de firewall do Windows, ou Manually para permitir que o administrador configure manualmente o firewall.

Depois de instalar o software em seus servidores de impressão, configure o Universal Print Server seguindo as instruções em Provisionar impressoras.

Mais informações

Para obter informações sobre como a Citrix reporta o resultado de instalações de componentes, consulte Códigos de retorno da instalação Citrix.