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 de 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 pela linha de comando
- Para instalar um VDA (e ver o progresso da execução do comando e os valores de retorno), você deve ter permissões administrativas elevadas ou usar **Executar como administrador**.
- 1. Na máquina onde você está instalando o VDA, faça login no [Citrix Cloud](https://citrix.cloud.com).
- No menu superior esquerdo, selecione Soluções > DaaS.
-
- No lado superior direito, clique em Downloads e selecione Baixar VDA. Você será redirecionado para a página de download do VDA. Encontre o instalador do VDA que você deseja e clique em Baixar Arquivo.
-
-
- 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 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 falha.) 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
Opções de linha de comando para instalar um VDA
-
As opções a seguir são válidas com um ou mais dos comandos:
VDAServerSetup.exe,VDAWorkstationSetup.exeeVDAWorkstationCoreSetup.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
pluginsfor omitida, apenas o VDA será instalado (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 [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_guide/controllerssimultaneamente. -
/disableexperiencemetrics
-
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 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 as portas UDP que o transporte adaptativo HDX usa, 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 adaptativo HDX exige, 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 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_portsse quiser que as portas UDP sejam abertas automaticamente quando o Serviço de Firewall do Windows for detectado. -
/enable_remote_assistance
Ativa o recurso de sombreamento na Assistência Remota do Windows para uso com as funções de Monitor. 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) Ativa o retorno automático ao ponto de restauração, caso a instalação ou atualização do VDA falhe.
Se a instalação/atualização for concluída com sucesso:
-
/enablerestorecleanupinstrui o instalador a remover o ponto de restauração. -
/enablerestoreinstrui 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 do Windows 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 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 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 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 Profile Management de terceiros, a Citrix recomenda que você instale e execute o serviço Citrix Profile Management. A habilitação do serviço Citrix Profile Management não é obrigatória.
-
Se você planeja usar o MCS para provisionar VMs, não exclua o Machine Identity Service.
Se você especificar
/excludee/includeadditionalcom 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 retas. Os nomes dos componentes diferenciam maiúsculas de minúsculas.
Esta opção pode ser útil ao criar uma implantação de Acesso Remoto para 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 Personalization for App-V - VDA
- Citrix MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
- User personalization layer
- Citrix Web Socket VDA Registration Tool
Se você especificar
/excludee/includeadditionalcom 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.
-
/masterimage
-
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. -
/mastermcsimage
Especifica que esta máquina será usada como uma imagem com o Machine Creation Services. Esta opção é equivalente a
/masterimage. -
/masterpvsimage
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 compatíveis do Windows já vem com o Media Foundation instalado, exceto as edições N.
-
/nodesktopexperience
Válido apenas ao instalar um VDA de SO multiusuário. Impede a habilitação do recurso Enhanced Desktop Experience. Este recurso também é controlado pela 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 antes 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. -
/portnumber 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 a ser usado com o protocolo Rendezvous. Para obter 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
- Formato do endereço do proxy:
-
/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 do VDA configuradas anteriormente quando usado com as opções
/portnumber,/controllersou/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. -
/remotepc
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.
-
/remove
Remove os componentes especificados com a opção
/components. -
/removeall
Remove o VDA. 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
/disableexperiencemetricsfor 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 um servidor Windows compatível. Omita esta opção ao instalar um VDA de múltiplas sessões em um servidor Windows. Antes de usar esta opção, consulte Server VDI.
-
/site_guid guid
Identificador Globalmente Único (GUID) da Unidade Organizacional (OU) do Active Directory do site. Isso associa um desktop virtual a um site quando você usa 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_guide/controllerssimultaneamente. -
/tempdir directory
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.
-
/virtualmachine
Válido apenas ao instalar um VDA em uma VM. Substitui a detecção de uma máquina física pelo instalador, 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.
-
/xendesktopcloud
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 múltiplas sessões. O comando a seguir instala um VDA em um SO de múltiplas sessões.
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimageO VDA será usado como uma imagem.
-
Instalar um VDA de SO de múltiplas sessões ou um VDA de SO de sessão única. O comando a seguir instala um VDA de SO de múltiplas sessões 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 /norebootSepare cada FQDN do delivery controller™ por uma vírgula. Observe que
XXXXrepresenta 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 uma implantação de Acesso Remoto a PC ou VDA.
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /norebootO 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
Após instalar um VDA, você pode personalizar várias configurações. Execute XenDesktopVDASetup.exe, usando uma ou mais das seguintes opções.
-
/reconfigure(obrigatório ao personalizar um VDA) -
/hou/help /quiet/noreboot/controllers/portnumber port/enable_hdx_ports
Próximas etapas
-
Para revisar todo o processo de configuração, consulte Planejar e criar uma implantação.