Instalar usando a linha de comando
Importante:
Se você estiver atualizando e sua versão atual usa ou tem o software Personal vDisk ou AppDisks instalado, consulte Removendo 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 Dados de licenciamento da Citrix.
Introdução
Este artigo se aplica à instalação de componentes em máquinas com sistemas operacionais Windows. Para obter informações sobre VDAs para sistemas operacionais Linux, consulte Linux Virtual Delivery Agents.
Este artigo descreve como emitir comandos de instalação de produtos. Antes de iniciar qualquer instalação, revise Preparar para instalar. Esse 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 Executar como administrador. Para obter mais informações, consulte a documentação do comando da Microsoft.
Como complemento ao uso direto dos comandos de instalação, 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 o guiará para informações sobre suas opções. Veja Sistemas operacionais anteriores.
Para obter informações sobre como o Citrix relata os resultados das instalações de componentes, consulte Códigos de retorno de instalação do Citrix.
Use o instalador completo do produto
Para acessar a interface de linha de comando do instalador completo do produto:
- Baixe o pacote do produto da Citrix. As credenciais da conta Citrix são necessárias para acessar o site de download.
- Descompacte o arquivo. Opcionalmente, grave um DVD do arquivo ISO.
- Efetue logon no servidor onde você está instalando os componentes usando uma conta de administrador local.
- Insira o DVD na unidade ou monte o arquivo ISO.
-
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 pastax64 > 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 usar a interface gráfica.
Para instalar a Gravação de Sessão: Siga as orientações em Gravação de Sessão.
Para instalar o Workspace Environment Management: Siga as orientações em Workspace Environment Management.
Para instalar o Secure Private Access: Execute
XenDesktopSPASetup.exe
na pastax64 > XenDesktop
Setup na mídia de instalação. Siga as orientações em Opções de linha de comando para instalar um Secure Private Access.
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 mais detalhes sobre as opções, consulte Instalar componentes principais.
-
/ceipoptina ceipoptina [,ceipoptina] …
Permite a coleta de dados do Call Home e do Programa de Melhoria da Experiência do Cliente (CEIP). Os valores válidos são:
-
DIAGNÓSTICO
: Escolha este valor para permitir que o Licenciamento Citrix colete dados do Call Home. -
ANÔNIMO
: Escolha este valor para permitir que o Licenciamento Citrix colete dados CEIP não identificados (que não identificam usuários). -
NENHUM
: Escolha este valor para desabilitar a coleta de dados do CEIP pelo Citrix Licensing.
Para obter mais informações sobre a coleta de dados do Call Home, consulte Licenciamento do Citrix Call Home.
Para obter mais detalhes sobre a coleta de dados do CEIP, consulte Programa de Melhoria da Experiência do Cliente de Licenciamento da Citrix.
Para obter mais detalhes sobre os dados do CEIP, consulte Elementos de dados do CEIP de licenciamento da Citrix.
Para obter mais detalhes sobre os dados de licenciamento do License Server, consulte Dados de licenciamento da Citrix.
-
-
/componentes componente [,componente] …
Lista separada por vírgulas de componentes para instalar ou remover. Os valores válidos são:
-
CONTROLADOR
: Controlador -
DESKTOPSTUDIO
: Estúdio -
WEBSTUDIO
: Estúdio Web -
DESKTOPDIRECTOR
: Diretor -
LICENSESERVER
: Servidor de licença Citrix -
SECUREPRIVATEACCESS
: Acesso privado seguro
Se esta opção for omitida, todos os componentes serão instalados (ou removidos, se a opção
/remove
também for especificada).(Em versões anteriores a 2003, os valores válidos incluíam
STOREFRONT
. Para a versão 2003 e posteriores, use o comando de instalação dedicado do StoreFront mencionado em Use o instalador completo do produto). -
-
/configurar_firewall
Abre todas as portas no firewall do Windows usadas pelos componentes que estão sendo instalados, se o Serviço de Firewall do Windows estiver em execução, mesmo que o firewall não esteja habilitado. Se estiver usando um firewall de terceiros ou nenhum firewall, você deverá abrir as portas manualmente.
-
/desabilitar métricas de experiência
Impede o upload automático de análises coletadas durante a instalação, atualização ou remoção para o Citrix.
-
/excluir “recurso”[,”recurso”]
Impede a instalação de um ou mais recursos, serviços ou tecnologias separados por vírgula, cada um entre aspas retas. Os valores válidos são:
-
"Armazenamento de cache do host local (LocalDB)"
: Impede a instalação do banco de dados usado para o cache do host local. Esta opção não afeta se o SQL Server Express está instalado para uso como banco de dados do site.
-
-
/ajuda ou /h
Exibe ajuda de comando.
-
/ignorar_hw_verificar_falha
Permite que a instalação ou atualização do Delivery Controller continue, mesmo se as verificações de hardware falharem (por exemplo, devido à RAM insuficiente). Para mais informações, consulte Verificação de hardware.
-
/ignorar_site_teste_falha
Válido somente durante a atualização do controlador. Normalmente, quaisquer falhas nos testes do site são ignoradas e a atualização prossegue. Se omitido (ou definido como falso), qualquer falha no teste do site fará com que o instalador falhe, sem executar a atualização. Padrão = falso
Durante uma atualização, esta opção será ignorada se uma versão não suportada do SQL Server for detectada. Para obter detalhes, consulte Verificação de versão do SQL Server.
-
/installdirdiretório**
Diretório vazio existente onde os componentes serão instalados. Padrão = c:\Arquivos de Programas\Citrix.
-
/logpathcaminho**
Localização do arquivo de log. A pasta especificada deve existir. O instalador não o cria. Padrão =
TEMP%\Citrix\XeInstalador nDesktop
-
/sem_assistência_remota
Válido somente ao instalar o Director. Desativa o recurso de sombra do 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 é habilitada por padrão.)
-
/noresume
Por padrão, quando é necessário reiniciar a máquina durante uma instalação, o instalador reinicia 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. -
/nosql
Impede a instalação do Microsoft SQL Server Express no servidor onde você está instalando o Controlador. Se esta opção for omitida, o SQL Server Express será instalado para uso como banco de dados do site.
Esta opção não afeta a instalação do SQL Server Express LocalDB usado para o Cache do Host Local.
-
/silencioso ou /passivo
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.
-
/remover
Remove os componentes principais especificados com a opção
/components
. -
/remover tudo
Remove todos os componentes principais instalados.
-
/SKIPHDXDRIVERCHECK
Ignora a verificação dos drivers HDX para o VDA Meta-installer.
-
/enviar métricas de experiência
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 especificado), as análises serão coletadas localmente, mas não enviadas automaticamente. -
/tempdir diretório
Diretório que contém 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 comunicação de componentes são abertas automaticamente.
\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall
O comando a seguir instala um Delivery Controller, Secure Private Access e SQL Server Express em um servidor. As portas de firewall necessárias para comunicação de componentes são abertas automaticamente.
\x64\XenDesktop Setup
XenDesktopServerSetup.exe /xenapp /components controller,secureprivateaccess /configure_firewall
Use um instalador VDA autônomo
As credenciais da conta 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.
- Baixe o pacote apropriado da Citrix:
- Agente de entrega virtual do sistema operacional multissessão:
VDAServerSetup_xxxx.exe
- Agente de entrega virtual de sistema operacional de sessão única:
VDAWorkstationSetup_xxxx.exe
- Agente de entrega virtual de serviços principais do sistema operacional de sessão única:
VDAWorkstationCoreSetup_xxxx.exe
- Agente de entrega virtual do sistema operacional multissessão:
-
Primeiro, extraia os arquivos do pacote para um diretório existente e depois 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 exemploC:\YourExtractFolder\VDAWorkstationCoreSetup.exe /extract %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.-
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 seu nome:
VDAServerSetup.exe
,VDAWorkstationSetup.exe
ouVDAWorkstationCoreSetup.exe
. Use as opções válidas listadas neste artigo. -
Se você estiver familiarizado com o instalador completo do produto:
-
Execute o instalador autônomo
VDAServerSetup.exe
ouVDAWorkstationSetup.exe
como se fosse o comandoXenDesktopVdaSetup.exe
em tudo, exceto no 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 mais detalhes sobre as opções, consulte Instalar VDAs.
-
/componentes componente[,componente]
Lista separada por vírgulas de componentes para instalar ou remover. 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 para Windows, especifique
/components vda,plugins
ou não especifique nenhum componente. Se nenhum componente for especificado, somente o VDA será instalado por padrão.Para instalar somente o VDA e excluir a instalação do aplicativo Citrix Workspace, especifique
/components vda
.Esta opção não é válida ao usar o instalador
VDAWorkstationCoreSetup_xxxx.exe
. Esse instalador não pode instalar o aplicativo Citrix Workspace. -
-
/controladores “controlador [controlador]”
FQDNs separados por espaços de controladores com os quais o VDA pode se comunicar, colocados entre aspas retas. Não especifique as opções
/site_guid
e/controllers
. -
/desabilitar métricas de experiência
Impede o upload automático de análises coletadas durante a instalação, atualização ou remoção para o Citrix.
-
/habilitar_hdx_portas
Abre portas no firewall do Windows exigidas pelo VDA e recursos habilitados (exceto a Assistência Remota do Windows), 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 nenhum firewall, você 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 desta opção/enable_hdx_ports
. -
/ativar_hdx_udp_portas
Abre portas UDP no firewall do Windows que o transporte adaptável HDX usa, 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 nenhum firewall, você deverá configurar o firewall manualmente. Para obter informações sobre portas, consulte Portas de rede.
Para abrir portas extras que o VDA usa, especifique a opção
/enable_hdx_ports
, além desta opção/enable_hdx_udp_ports
. -
/enable_hdx_tls_dtls
Abre a porta TCP e UDP 443 para o HDX Direct V1.
-
/habilitar_transporte_em_tempo_real
Habilita ou desabilita o uso de UDP para pacotes de áudio (RealTime Audio Transport para áudio). Habilitar 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 de Firewall do Windows for detectado. -
/ativar_assistência_remota
Habilita 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 abrirá as portas dinâmicas no firewall.
-
/enablerestore ou /enablerestorecleanup
(Válido somente 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:
-
/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 Restaurar em caso de falha de instalação ou atualização.
-
-
/habilitar_ss_portas
Abre portas no Firewall do Windows 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 nenhum firewall, você 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 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 do sistema operacional de sessão única Citrix App Protection Component
Citrix App Protection Component
Citrix App Protection Component
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 HyperV Filter Driver
Citrix HyperV Filter Driver
Citrix MCS IODriver
Citrix MCS IODriver
Citrix Personalization for App-V - VDA
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 Telemetry Service
Citrix Telemetry Service
Citrix Telemetry Service
Citrix Universal Print Client
Citrix Universal Print Client
Citrix Universal Print Client
Citrix Vda Log Capture Service
Citrix Vda Log Capture Service
Citrix Vda Log Capture Service
Citrix VDA Upgrade Agent
Citrix VDA Upgrade Agent
CSE Component
CSE Component
CSE Component
Director VDA Plug-in
Director VDA Plug-in
Director VDA Plug-in
Machine Identity Service
Machine Identity Service
Machine Management Provider
Machine Management Provider
Machine Management Provider
User Personalization Layer
VDA Monitor Plug-in
VDA Monitor Plug-in
VDA Monitor Plug-in
VDA WMI Proxy Plug-in
VDA WMI Proxy Plug-in
VDA WMI Proxy Plug-in
A exclusão do 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 Detalhes do usuário e EndPoint , o painel Personalização e o painel Duração do logon 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 se você estiver 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. Não é necessário habilitar o Citrix Profile Management Service.
Se você especificar
/exclude
e/includeadditional
com o mesmo nome de componente, esse componente não será instalado.Esta opção não é válida ao usar o instalador
VDAWorkstationCoreSetup.exe
. O instalador exclui automaticamente muitos desses itens. -
/h ou /ajuda
Exibe ajuda de comando.
-
/includeadditional “componente”[,”componente”]
Inclui a instalação de um ou mais componentes opcionais separados por vírgula, cada um entre aspas retas. Esta opção pode ser útil quando você estiver criando uma implantação de acesso remoto a PC 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, esse componente não será instalado. -
/installdir diretório
Diretório vazio existente onde os componentes serão instalados. Padrão = c:\Arquivos de Programas\Citrix.
-
/instalar_driver_mcsio
Não utilizar. 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 o cria. Padrão = “%TEMP%\Citrix\XeInstalador nDesktop”
Esta opção não está disponível na interface gráfica.
-
/imagem-mestre
Válido somente ao instalar um VDA em uma VM. Configura o VDA como uma imagem a ser usada para criar outras máquinas. Esta opção é equivalente a
/mastermcsimage
.Esta opção não é válida ao usar o instalador
VDAWorkstationCoreSetup_xxxx.exe
. -
/mastermcsimage
Especifica que esta máquina será usada como uma imagem com os Serviços de Criação de Máquina. 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) para provisionar VMs.
-
/websockettoken WebSocketToken
Cria um Web Socket VDA. O WebSocketToken é para o token necessário.
-
/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 esta 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 serão atendidas. A maioria das edições suportadas do Windows já vem com o Media Foundation instalado, exceto as edições N. Se você habilitar os 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. -
/experiência de desktop node
O recurso Experiência de Área de Trabalho Aprimorada não está mais disponível. Esta opção (e configuração de política) será ignorada, se especificada.
Válido somente ao instalar um VDA para sistema operacional multissessão. 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 Enhanced Desktop Experience da Citrix.
-
/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 é necessário reiniciar a máquina durante uma instalação, o instalador reinicia 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. -
/máquinafísica
Use este argumento junto com
/remotepc
para instalação do RemotePC. Caso contrário, o VDA pode não se comportar como esperado em certos cenários de usuário. -
/númerodaporta porta
Válido somente quando a opção
/reconfig
é especificada. Número da porta para habilitar as comunicações entre o VDA e o Controlador. A porta configurada anteriormente é desabilitada, a menos que seja a porta 80. -
/proxyconfig “endereço ou caminho do arquivo PAC”
Se você planeja usar o protocolo Rendezvous V2 com um serviço como o Gateway Service em seu ambiente e tiver um proxy não transparente em sua rede para conexões de saída, especifique o proxy aqui. Somente proxies HTTP são suportados. O endereço ou caminho do arquivo PAC do proxy para uso com o protocolo Rendezvous. Para detalhes dos recursos, 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:
-
/silencioso ou /passivo
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.
-
/reconfigurar
Personaliza as configurações do VDA configuradas anteriormente quando usado 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 será iniciada. -
/computadorremoto
Válido somente para implantações de acesso remoto a PC (SO de sessão única) ou conexões intermediadas (SO de várias sessões). Exclui a instalação de quaisquer componentes adicionais (veja as listas de componentes com as opções
/exclude
e/includeadditional
).Esta opção não é válida ao usar o instalador
VDAWorkstationCoreSetup.exe
. O instalador exclui automaticamente a instalação desses componentes./remotepc
não é compatível com a opção/servervdi
. -
/remover
Remove os componentes especificados com a opção
/components
. -
/remove_appdisk_ack
Autoriza o instalador do VDA a desinstalar o plug-in AppDisks VDA, se estiver instalado.
-
/remover_pvd_ack
Autoriza o instalador do VDA a desinstalar o Personal vDisk, se estiver instalado.
-
/remover tudo
Remove o VDA. Ele não remove o aplicativo Citrix Workspace (se instalado).
-
/REMOVERTUDOCOMWA
Remove o CWA junto com o VDA.
-
/enviar métricas de experiência
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 serão coletadas localmente, mas não enviadas automaticamente. -
/servidorvdi
Instala um VDA para sistema operacional de sessão única em uma máquina Windows multissessão suportada. Omita esta opção ao instalar um VDA para sistema operacional multissessão em uma máquina Windows multissessão.
Antes de usar esta opção, consulte Server VDI.
Use esta opção somente com o instalador VDA do produto completo.
-
/site_guid guia
Identificador global exclusivo da unidade organizacional (UO) do Active Directory do site. Isso 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 padrão). O GUID do site é uma propriedade do site exibida no Studio. Não especifique as opções
/site_guid
e/controllers
. -
/tempdir diretório
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.
-
/máquina virtual
Válido somente ao instalar um VDA em uma VM. Substitui a detecção feita 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
Instale um VDA com o instalador completo do produto:
O comando a seguir instala um VDA para sistema operacional de sessão única e o aplicativo Citrix Workspace no local padrão em uma VM. Este VDA será usado como uma imagem e usará o MCS para provisionar VMs. O VDA será registrado inicialmente com o Controlador no servidor chamado 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 sistema operacional de sessão única com o instalador autônomo VDAWorkstationCoreSetup:
O comando a seguir instala um Core Services VDA em um sistema operacional de sessão única para uso em uma implantação de VDI ou acesso remoto a PC. O aplicativo Citrix Workspace e outros serviços não essenciais não estão instalados. O endereço de um Controlador é especificado e as portas no Serviço de Firewall do Windows serão abertas automaticamente. O administrador cuidará das reinicializações.
VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
Personalize um VDA
Depois de instalar um VDA, você pode personalizar diversas configurações. No diretório \x64\XenDesktop Setup
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 ao personalizar um VDA) -
/h
ou/ajuda
/quiet
/noreboot
/controllers
/portnumber port
/enable_hdx_ports
Solucionar problemas de VDAs
-
Na exibição do Studio para um grupo de entrega, a entrada Versão do VDA instalada no painel Detalhes pode não ser 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.
-
Após a instalação de um VDA, ele não pode entregar aplicativos ou um desktop aos usuários até que seja registrado em um Delivery Controller.
Para saber mais sobre os métodos de registro do VDA e como solucionar problemas de registro, consulte Registro do 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
Quando esta opção não é especificada, o instalador exibe a página Firewall na interface gráfica. Selecione Automaticamente para que o instalador adicione automaticamente as regras do firewall do Windows ou Manualmente 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 usando as orientações em Provisionar impressoras.
Opções de linha de comando para instalar um Secure Private Access
As seguintes opções são válidas com:
- Instalador CVAD:
XenDesktopSPASetup.exe
- Instalador SPA local:
SecurePrivateAccessSetup_XXXX.exe
-
/habilitar_portas_spa
Abre portas no firewall do Windows exigidas pelo Secure Private Access, 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 nenhum firewall, você deverá configurar o firewall manualmente. Para obter informações sobre portas, consulte Portas de rede.
-
/nosql
Impede a instalação do Microsoft SQL Server Express no servidor onde você está instalando o Secure Private Access. Se esta opção for omitida, o SQL Server Express será instalado para uso como banco de dados do site.
-
/help ou /h ou /?
Exibe ajuda de comando
-
/noreboot
Impede uma reinicialização após a instalação. O Secure Private Access não pode ser usado até depois de uma reinicialização.
-
/silencioso ou /passivo
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.
-
/remover
Remove o Acesso Privado Seguro.
Para mais detalhes sobre as opções, consulte Instalador do Secure Private Access.
Mais informações
Para obter informações sobre como o Citrix relata o resultado das instalações de componentes, consulte Códigos de retorno de instalação do Citrix.
Neste artigo
- Introdução
- Use o instalador completo do produto
- Opções de linha de comando para instalar componentes principais
- Exemplos de instalação de componentes principais
- Use um instalador VDA autônomo
- Opções de linha de comando para instalar um VDA
- Exemplos de instalação de um VDA
- Personalize um VDA
- Solucionar problemas de VDAs
- Opções de linha de comando para instalar um servidor de impressão universal
- Opções de linha de comando para instalar um Secure Private Access
- Mais informações