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”.
- Na máquina onde você está instalando o VDA, entre no Citrix Cloud.
- 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 seguintes opções são válidas com um ou mais dos comandos: VDAServerSetup.exe, VDAWorkstationSetup.exe e VDAWorkstationCoreSetup.exe.
-
/components component[,component]
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 “controller [controller]…”
FQDNs separados por espaço dos Citrix Cloud Connectors com os quais o VDA pode se comunicar, entre aspas retas. Não especifique as opções
/site_guide/controllers. -
/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 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, deve configurar o firewall manualmente. Para obter informações sobre portas, consulte Portas de rede.
Para abrir as portas UDP que o transporte adaptativo HDX, especifique a opção
/enable_hdx_udp_ports, além da opção/enable_hdx_ports. -
/enable_hdx_udp_ports
Abre 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 habilitado. Se você estiver usando um firewall diferente ou nenhum firewall, deve 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 (RealTime Audio Transport para áudio). Habilitar este 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
Habilita 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) 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 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 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, deve configurar o firewall manualmente.
-
/exclude “component”[,”component”]
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 por MCS precisa do componente Machine Identity Service. Os valores válidos são:
- Serviço de Identidade da Máquina
- Gerenciamento de Perfil Citrix
- Plug-in WMI do Gerenciamento de Perfil Citrix
- Personalização Citrix para App-V - VDA
- Citrix MCS IODriver
- Agente de Atualização do VDA Citrix
- Citrix Rendezvous V2
Excluir o Gerenciamento de Perfil Citrix 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 Gerenciamento de Perfil instalado.Mesmo que você esteja usando uma solução de Gerenciamento de Perfil de terceiros, a Citrix recomenda que você instale e execute o Serviço de Gerenciamento de Perfil Citrix. A habilitação do Serviço de Gerenciamento de Perfil Citrix 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
/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 “component”[,”component”] …
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.
Esta opção pode ser útil ao criar uma implantação de Acesso Remoto a PC, e deseja instalar componentes que não estão incluídos por padrão. Os valores válidos são:
- Gerenciamento de Perfil Citrix
- Plug-in WMI do Gerenciamento de Perfil Citrix
- Personalização Citrix para App-V - VDA
- Citrix MCS IODriver
- Agente de Atualização do VDA Citrix
- Citrix Rendezvous V2
- Camada de personalização do usuário
- Ferramenta de Registro de VDA de Web Socket Citrix
Se você especificar
/excludee/includeadditionalcom o mesmo nome de componente, esse componente não será instalado. -
/installdir directory
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 path
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 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.
-
/nodesktopexperience
Válido apenas ao instalar um VDA de SO multi-sessão. Impede a habilitação do recurso Enhanced Desktop Experience. Este recurso também é controlado pela 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 antes de uma reinicialização.
-
/noresume
Por padrão, quando uma reinicialização da máquina é necessária durante uma instalação, o instalador retoma 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 port
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 “address or PAC file path”
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
- 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 multi-sessão).
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 suportado. Omita esta opção ao instalar um VDA multi-sessão em um servidor Windows. Antes de usar esta opção, consulte Server VDI.
-
/site_guid guid
Identificador Globalmente Único da Unidade Organizacional (OU) do Active Directory do site. Isso associa um desktop 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_guide/controllers. -
/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 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.
-
/xendesktopcloud
Indica que o VDA está instalado em uma implantação Citrix DaaS (Citrix Cloud™).
Exemplos: Instalar um VDA
-
Instalar um VDA em um SO multi-sessão. O comando a seguir instala um VDA em um SO multi-sessão.
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimageO VDA será usado como uma imagem.
-
Instalar um VDA de SO multi-sessão ou um 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 /norebootSepare cada FQDN do delivery controller™ por uma vírgula. Observe que
XXXXrepresenta a versão do VDA. -
Instalar um VDA de Serviços Principais em um SO de sessão única. O comando a seguir instala um VDA de Serviços Principais 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
Onde ir em seguida
-
Para revisar todo o processo de configuração, consulte Planejar e criar uma implantação.