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, 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 a partir da linha de comando
Para instalar um VDA (e ver o progresso da execução do comando e os valores retornados), você deve ter permissões administrativas elevadas ou usar Executar como administrador.
- Na máquina em que você está instalando o VDA, assine para Nuvem Citrix.
- No menu superior esquerdo, selecione Meus serviços > DaaS.
- No canto superior direito, clique em Downloads e selecione Baixar VDA. Você é redirecionado para o Página de download do VDA. Encontre o instalador do VDA desejado e clique em Baixar arquivo.
-
Após a conclusão do download, execute seu nome. Use as opções descritas neste artigo.
-
Para o agente de entrega virtual do sistema operacional de várias sessões, execute
VDAServerSetup.exe
-
Para o agente de entrega virtual do sistema operacional de sessão única, execute
VDAWorkstationSetup.exe
-
Para o Agente de Entrega Virtual de Serviços Principais do SO de sessão única, execute
VDAWorkstationCoreSetup.exe
-
Para extrair os arquivos antes de instalá-los, use /extrair
com o caminho absoluto, por exemplo .\VDAWorkstationCoreSetup.exe /extrair %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.
-
Durante
VDAServerSetup_XXXX.exe
correr<extract folder>\Extrair\Imagem-Cheia\x64\XeConfiguração do nDesktop\XenDesktopVDASetup.exe
-
Durante
VDAWorkstationCoreSetup_XXXX.exe
correr<extract folder>\Extrair\Imagem-Cheia\x64\XeConfiguração do nDesktop\XenDesktopRemotePCSetup.exe
-
Durante
VDAWorkstationSetup_XXXX.exe
correr<extract folder>\Extrair\Imagem-Cheia\x64\XeConfiguração do nDesktop\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
.
-
/Componentes componente[,componente]
Lista separada por vírgulas de componentes a serem instalados ou removidos. Os valores válidos são:
-
VDA: Agente de entrega virtual
-
PLUGINS: Aplicativo Citrix Workspace para Windows
Para instalar o aplicativo VDA e Citrix Workspace, especifique
/componentes vda,plugins
.Se o
Plugins
for deixada de fora, somente o VDA será instalado (não o aplicativo Citrix Workspace).Esta opção não é válida ao usar o
VDAWorkstationCoreSetup.exe
Instalador. Esse instalador não pode instalar o aplicativo Citrix Workspace. -
-
/Controladores “controlador [controlador]…”
FQDNs separados por espaço do Citrix Cloud Connectors com os quais o VDA pode se comunicar, entre aspas retas. Não especifique o
/site_guid
e/Controladores
Opções. -
/desativarexperiênciamétricas
Impede o upload automático de análises coletadas durante a instalação, atualização ou remoção para o 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, deverá configurar o firewall manualmente. Para obter informações sobre a porta, consulte Portas de rede.
Para abrir as portas UDP que o transporte adaptável HDX, especifique o
/enable_hdx_udp_ports
opção, além da opção/enable_hdx_ports
opção. -
/enable_hdx_udp_ports
Abre portas UDP no firewall do Windows que o transporte adaptável 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, deverá configurar o firewall manualmente. Para obter informações sobre a porta, consulte Portas de rede.
Para abrir as portas que o VDA usa, especifique o
/enable_hdx_ports
opção, além da opção/enable_hdx_udp_ports
opção. -
/enable_real_time_transport
Habilita ou desabilita o uso de UDP para pacotes de áudio (RealTime Audio Transport para áudio). Ativar esse recurso pode melhorar o desempenho do áudio. Inclua o
/enable_hdx_ports
opção se 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 o Monitor Funções. Se você especificar essa 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) 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 êxito:
-
/enablerestorecleanup
instrui o instalador a remover o ponto de restauração. -
/enablerestore
instrui o instalador a manter o ponto de restauração, mesmo que ele não tenha sido usado.
Para obter detalhes, consulte Restauração 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, deverá configurar o firewall manualmente.
-
/excluir “componente”[,”componente”]
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 pelo MCS precisa do componente Machine Identity Service. Os valores válidos são:
- Serviço de Identidade de Máquina
- Gerenciamento de perfis Citrix
- Citrix Profile Management WMI Plug-in
- Citrix Personalization for App-V - VDA
- Citrix MCS IODriver
- Agente de atualização do Citrix VDA
- Citrix Rendezvous V2
Excluindo o Citrix Profile Management da instalação (
/exclude "Citrix Profile Management"
) afeta o monitoramento e a solução de problemas de VDAs do Monitor consolar. No Detalhes do usuário e Extremidade , o painel Personalização e o painel Duração do logon falharão. No Painel e Tendências , o painel Duração média do logon exibirá dados somente para máquinas que têm o Gerenciamento de perfis instalado.Mesmo se você estiver usando uma solução de gerenciamento de perfil de terceiros, a Citrix recomenda que você instale e execute o Citrix Profile Management Service. Não é necessário ativar o Citrix Profile Management Service.
Se você planeja usar o MCS para provisionar VMs, não exclua o Machine Identity Service.
Se você especificar ambos
/excluir
e/includeadicional
Com o mesmo nome de componente, o componente não é instalado.Esta opção não é válida ao usar o
VDAWorkstationCoreSetup.exe
Instalador. Esse instalador exclui automaticamente muitos desses itens. -
/h ou /Ajuda
Exibe a ajuda do comando.
-
/includeadicional “componente”[,”componente”] …
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.
Essa opção pode ser útil quando você está criando uma implantação do Remote PC Access e deseja instalar componentes que não estão incluídos por padrão. Os valores válidos são:
- Gerenciamento de perfis Citrix
- Citrix Profile Management WMI Plug-in
- Citrix Personalization for App-V - VDA
- Citrix MCS IODriver
- Agente de atualização do Citrix VDA
- Citrix Rendezvous V2
- Camada de personalização do usuário
- Ferramenta de registro Citrix Web Socket VDA
Se você especificar ambos
/excluir
e/includeadicional
com o mesmo nome de componente, esse componente não está instalado. -
/installdir diretório
Diretório vazio existente onde os componentes serão instalados. Padrão = c:\Arquivos de Programas\Citrix.
-
/install_mcsio_driver
Não use. Em vez disso, use
/includeadicional "Citrix MCS IODriver"
ou/exclude "Citrix MCS IODriver"
-
/logpath caminho
Local do arquivo de log. A pasta especificada deve existir. O instalador não o cria. Padrão = “%TEMP%\ Citrix\XenDesktop Installer”
Esta opção não está disponível na interface gráfica.
-
/imagem mestra
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 ao usar o
VDAWorkstationCoreSetup.exe
Instalador. -
/mastermcsimage
Especifica que essa máquina será usada como uma imagem com os Serviços de Criação de Máquina. Esta opção é equivalente a
/imagem mestra
. -
/masterpvsimage
Especifica que essa 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 essa 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 com suporte vem com o Media Foundation já instalado, exceto as edições N.
-
/nodesktopexperience
Válido somente ao instalar um VDA de SO de várias sessões. Impede a ativação do recurso Experiência de Área de Trabalho Aprimorada. Esse recurso também é controlado com a 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 até depois 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. -
/número da porta porta
Válido somente quando o
/reconfig
é especificada. Número da porta para permitir a comunicação entre o VDA e o controlador. A porta configurada anteriormente está desabilitada, a menos que seja a porta 80. -
/proxyconfig “endereço ou caminho do arquivo PAC”
Válido somente se o comando contiver
/includeadicional "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 de encontro.- 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:
-
/quieto ou /passivo
Nenhuma interface do 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 essa opção for omitida, a interface gráfica será iniciada.
-
/Reconfigurar
Personaliza as configurações de VDA configuradas anteriormente quando usado com o
/número da porta
,/Controladores
ou/enable_hdx_ports
Opções. Se você especificar essa opção sem especificar também o/quieto
, a interface gráfica para personalizar os lançamentos do VDA. -
/remotepc
Válido apenas para implantações de Acesso ao PC Remoto (sistema operacional de sessão única) ou conexões agenciadas (sistema operacional de várias sessões).
Esta opção não é válida ao usar o
VDAWorkstationCoreSetup.exe
Instalador. Esse instalador exclui automaticamente a instalação desses componentes. -
/remove_appdisk_ack
Autoriza o instalador do VDA a desinstalar o plug-in VDA do AppDisks se ele estiver instalado.
-
/remove_pvd_ack
Autoriza o instalador do VDA a desinstalar o Personal vDisk se estiver instalado.
-
/retirar
Remove os componentes especificados com o
/Componentes
opção. -
/remover tudo
Remove o VDA. Ele não remove o aplicativo Citrix Workspace (se instalado).
-
/sendexperiencemetrics
Envia automaticamente as análises coletadas durante a instalação, atualização ou remoção para a Citrix. Se essa opção for omitida (ou o
/desativarexperiênciamétricas
for especificada), as análises serão coletadas localmente, mas não enviadas automaticamente. -
/servervdi
Instala um VDA de SO de sessão única em um servidor Windows compatível. Omita essa opção ao instalar um VDA de várias sessões 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. 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 o
/site_guid
e/Controladores
Opções. -
/tempdir diretório
Diretório para armazenar arquivos temporários durante a instalação. Padrão = c:\Windows\Tpem.
Esta opção não está disponível na interface gráfica.
-
/máquina virtual
Válido somente ao instalar um VDA em uma VM. Substitui a detecção pelo instalador de uma máquina física, em que 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
-
Instale um VDA em um sistema operacional de várias sessões. O comando a seguir instala um VDA em um sistema operacional de várias sessões.
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimage
O VDA será usado como uma imagem.
-
Instale um VDA de SO de várias sessões ou um VDA de SO de sessão única. O comando a seguir instala um VDA do sistema operacional de várias sessões ou um VDA do sistema operacional 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 /noreboot
Separe cada FQDN do controlador de entrega por uma vírgula. Observe que
XXXX
representa a versão do VDA. -
Instale um VDA de serviços principais em um sistema operacional de sessão única. O comando a seguir instala um VDA de serviços principais em um sistema operacional de sessão única para uso em uma implantação de acesso remoto ao PC ou VDA.
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
O aplicativo Citrix Workspace e outros serviços não essenciais não estã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 reinicializações.
Personalizar um VDA usando a linha de comando
Depois de instalar um VDA, você pode personalizar várias configurações. Correr XenDesktopVDASetup.exe
, usando uma ou mais das opções a seguir.
-
/Reconfigurar
(necessário ao personalizar um VDA) -
/h
or/help
/quiet
/noreboot
/controllers
/portnumber port
/enable_hdx_ports
Para onde ir a seguir
-
Para revisar todo o processo de configuração, consulte Planejar e criar uma implantação.