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 do VDA. Antes de iniciar uma instalação, consulte Instalar VDAs para saber mais sobre as considerações de instalação, instaladores e o que você especifica durante a instalação.
Instalar um VDA a partir da 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 em que você está instalando o VDA, conecte-se ao Citrix Cloud.
- No menu superior esquerdo, selecione My Services > DaaS.
- No canto superior direito, clique em Downloads e selecione Download VDA. Você é redirecionado para a página de download do VDA. Encontre o instalador do VDA desejado e clique em Download File.
-
Após a conclusão do download, execute o nome. Use as opções descritas neste artigo.
-
Para o Virtual Delivery Agent de SO multissessão, execute
VDAServerSetup.exe -
Para o Virtual Delivery Agent de SO de sessão única, execute
VDAWorkstationSetup.exe -
Para o Core Services Virtual Delivery Agent 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. Do contrário, 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
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 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 deixada de lado, somente o VDA será instalado (o aplicativo Citrix Workspace não).Esta opção não é válida quando usar o instalador
VDAWorkstationCoreSetup.exe. Esse instalador não pode instalar o aplicativo Citrix Workspace. -
-
/controllers “controlador [*controlador*]…”
FQDNs separados por espaço de Citrix Cloud Connectors com os quais o VDA pode se comunicar, entre aspas retas normais. Não especifique ambas as opções
/site_guide/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 do 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 requer, 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 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 do 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 no Monitor. 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:
-
/enablerestorecleanupinstrui o instalador a remover o ponto de restauração. -
/enablerestoreinstrui o instalador a manter 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.
-
/exclude “componente”[,”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 gerenciada pelo MCS exige 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 Supportability Tools
- 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 resolução de problemas de VDAs por meio da guia Monitor. 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 Profile Management 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ê 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 é 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.
-
/includeadditional “componente”[,”componente”] …
Inclui a instalação de um ou mais componentes opcionais separados por vírgula, cada qual entre aspas retas normais. Os nomes dos componentes diferenciam maiúsculas de minúsculas.
Esta opção é útil quando você estiver criando uma implantação do Remote PC Access e quiser instalar componentes que não estã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 Supportability Tools
- Citrix MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
- Camada de personalização de usuário
- Ferramenta de registro de VDA Citrix Web Socket
Se você especificar
/excludee/includeadditionalcom 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. Esta opção é equivalente a
/mastermcsimage.Esta opção não é válida quando usar o instalador
VDAWorkstationCoreSetup.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).
-
/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 será malsucedida. A maioria das edições compatíveis do Windows vem com o Media Foundation já instalado, exceto as edições N.
-
/nodesktopexperience
Válido somente ao instalar um VDA com 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. -
/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. -
/proxyconfig “endereç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
- Formato de endereço 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 de VDA definidas anteriormente quando utilizado 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 é iniciada. -
/remotepc
Válido somente para implantações de Remote PC Access (SO de sessão única) ou conexões agenciadas (SO multissessão).
Esta opção não é válida quando usar o instalador
VDAWorkstationCoreSetup.exe. Esse instalador exclui automaticamente a instalação destes componentes. -
/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.
-
/remove
Remove os componentes especificados com a opção
/components. -
/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
/disableexperiencemetricsfor especificada), as análises são coletadas localmente, mas não são enviadas automaticamente. -
/servervdi
Instala um VDA com SO de sessão única em um servidor Windows compatível. Omita esta opção quando instalar um VDA com SO multissessão em um servidor Windows. Antes de usar essa opção, consulte VDI do servidor.
-
/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 em Manage > Full Configuration. Não especifique ambas as opções
/site_guide/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: instalar um VDA
-
Instalar um VDA em um SO multissesão. O comando a seguir instala um VDA em um SO multissessão.
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimageO VDA será usado como uma imagem.
-
Instalar um VDA de SO multissessão ou VDA de SO de sessão única. O comando a seguir instala um VDA de SO multissessão ou 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 de Delivery Controller por uma vírgula. Observe que
XXXXrepresenta a versão do VDA. -
Instale um Core Services VDA em um SO de sessão única. 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 de VDA.
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /norebootO aplicativo Citrix Workspace e outros serviços não principais não são instalados. O endereço de um Cloud Connector é especificado e as portas no Serviço do Firewall do Windows são abertas automaticamente. O administrador lida com as reinicializações.
Personalizar um VDA usando a linha de comando
Depois de instalar um VDA, você pode personalizar várias configurações. Execute XenDesktopVDASetup.exe usando uma ou mais das seguintes opções.
-
/reconfigure(necessário quando personalizar um VDA) -
/hou/help /quiet/noreboot/controllers/portnumber port/enable_hdx_ports
O que fazer a seguir
-
Para revisar todo o processo de configuração, consulte Planejar e criar uma implantação.