Instalar usando a linha de comando
Importante:
Se você estiver atualizando e sua versão atual usar ou tiver o software Personal vDisk ou AppDisks instalado, consulte Remover PvD, AppDisks e hosts não compatíveis.
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 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 Agentes de Entrega Virtual Linux.
Este artigo descreve como emitir comandos de instalação do produto. 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 de comandos da Microsoft.
Como complemento ao uso direto dos comandos de instalação, scripts de exemplo são fornecidos na 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 seja compatível com esta versão do Citrix Virtual Apps and Desktops, uma mensagem o guiará para informações sobre suas opções. Consulte Sistemas operacionais anteriores.
Para obter informações sobre como a Citrix relata os resultados das instalações de componentes, consulte Códigos de retorno de instalação da Citrix.
Usar 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. Credenciais de conta Citrix são necessárias para acessar o site de download.
- Descompacte o arquivo. Opcionalmente, grave um DVD do arquivo ISO.
- Faça 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 Setupna 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.execom as opções listadas em Opções de linha de comando para instalar um VDA.Para instalar o StoreFront: Execute
CitrixStoreFront-x64.exena pastax64 > StoreFrontna 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 Federated Authentication Service: A Citrix recomenda usar a interface gráfica.
Para instalar o Session Recording: Siga as orientações em Session Recording.
Para instalar o Workspace Environment Management: Siga as orientações em Workspace Environment Management.
Para instalar o Secure Private Access: Execute
XenDesktopSPASetup.exena pastax64 > XenDesktopSetup 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âmetro são válidas ao instalar componentes principais com o comando XenDesktopServerSetup.exe. Para obter mais detalhes sobre as opções, consulte Instalar componentes principais.
Nota:
- Não use
/excludeao usar opções de linha de comando para instalar componentes principais.- Se você atualizar um componente usando
/components, outros componentes também poderão ser atualizados. Isso é para evitar possíveis problemas de compatibilidade entre diferentes componentes.- Se você quiser atualizar apenas um componente, use o instalador individual desse componente. Consulte Atualizar uma implantação.
-
/ceipoptin ceipoptin [,ceipoptin] …
Habilita a coleta de dados do Call Home e dados do Programa de Melhoria da Experiência do Cliente (CEIP). Os valores válidos são:
-
DIAGNOSTIC: Escolha este valor para permitir que o Licenciamento Citrix colete dados do Call Home. -
ANONYMOUS: Escolha este valor para permitir que o Licenciamento Citrix colete dados CEIP não identificados (que não identificam usuários). -
NONE: Escolha este valor para desabilitar a coleta de dados CEIP pelo Licenciamento Citrix.
Para obter mais informações sobre a coleta de dados do Call Home, consulte Citrix Licensing Call Home.
Para obter mais detalhes sobre a coleta de dados CEIP, consulte Citrix Licensing Customer Experience Improvement Program.
Para obter mais detalhes sobre os dados CEIP, consulte Citrix Licensing CEIP data elements.
Para obter mais detalhes sobre os dados de licenciamento do License Server, consulte Citrix Licensing Data.
-
-
/components component [,component] …
Lista de componentes separados por vírgula para instalar ou remover. Os valores válidos são:
-
CONTROLLER: Controller -
DESKTOPSTUDIO: Studio -
WEBSTUDIO: Web Studio -
DESKTOPDIRECTOR: Director -
LICENSESERVER: Citrix License Server -
SECUREPRIVATEACCESS: Secure Private Access
-
Para instalar apenas o VDA e excluir a instalação de outros componentes Citrix, 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 ou outros componentes Citrix.
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 posterior, use o comando de instalação dedicado do StoreFront mencionado em Usar o instalador completo do produto).
-
/onlyprereqs
Somente os pré-requisitos para os componentes selecionados serão instalados. Nenhum componente do produto Citrix será instalado.
-
/configure_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 você estiver usando um firewall de terceiros ou nenhum firewall, deverá abrir as portas manualmente.
-
/disableexperiencemetrics
Impede o upload automático de análises coletadas durante a instalação, atualização ou remoção para a Citrix.
-
/precheckonly
Executa todas as verificações prévias e gera os resultados das verificações prévias sem iniciar a instalação ou atualização.
-
/help ou /h
Exibe a ajuda do comando.
-
/ignore_hw_check_failure
Permite que a instalação ou atualização do Delivery Controller continue, mesmo que as verificações de hardware falhem (por exemplo, devido a RAM insuficiente). Para obter mais informações, consulte Verificação de hardware.
-
/ignore_site_test_failure
Válido apenas durante a atualização do Controller. Geralmente, quaisquer falhas de teste de site são ignoradas e a atualização prossegue. Se omitido (ou definido como falso), qualquer falha de teste de site faz com que o instalador falhe, sem realizar a atualização. Padrão = falso
Durante uma atualização, esta opção é ignorada se uma versão não compatível do SQL Server for detectada. Para obter detalhes, consulte Verificação de versão do SQL Server.
-
/installdir directory
Diretório vazio existente onde os componentes serão instalados. Padrão = c:\Program Files\Citrix.
-
/logpath path
Local do arquivo de log. A pasta especificada deve existir. O instalador não a cria. Padrão =
TEMP%\Citrix\XenDesktop Installer -
/no_remote_assistance
Válido apenas ao instalar o Director. Desabilita o recurso de sombreamento de 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, uma reinicialização não é habilitada por padrã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. -
/nosql
Impede a instalação do Microsoft SQL Server Express no servidor onde você está instalando o Controller. Se esta opção for omitida, o SQL Server Express será instalado para ser usado como o banco de dados do site.
Esta opção não afeta a instalação do SQL Server Express LocalDB usado para o Local Host Cache.
-
/quiet ou /passive
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.
-
/remove
Remove os componentes principais especificados com a opção
/components. -
/removeall
Remove todos os componentes principais instalados.
-
/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
/disableexperiencemetricsfor especificada), as análises são coletadas localmente, mas não são enviadas automaticamente. -
/tempdir directory
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.
-
/precheckonly
Executa todas as verificações prévias e gera os resultados das verificações prévias sem iniciar a instalação ou atualização.
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 as comunicações dos componentes são abertas automaticamente.
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
<!--NeedCopy-->
O comando a seguir instala um Controller Citrix Virtual Apps™, Studio e SQL Server Express no servidor. As portas de firewall necessárias para a comunicação dos componentes são abertas automaticamente.
\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall
<!--NeedCopy-->
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 a comunicação dos componentes são abertas automaticamente.
\x64\XenDesktop Setup
XenDesktopServerSetup.exe /xenapp /components controller,secureprivateaccess /configure_firewall
<!--NeedCopy-->
Se você atualizar do Citrix Virtual Apps and Desktops versão 2407 para 2411 ou posterior, ou realizar uma nova instalação da versão 2411 ou posterior, atualize o License Server para a versão mais recente (versão 11.2.17 build 51000) como primeiro passo. Em seguida, atualize o Delivery Controller. Não fazer isso resultará na falha das instalações e atualizações de linha de comando. Execute os seguintes comandos para atualizar o License Server e componentes como Delivery Controller, Web Studio e Citrix Director (assumindo que você esteja dentro da pasta \x64 na ISO montada).
-
Execute o seguinte:
\x64\Licensing\CitrixLicensing.exe /quiet <!--NeedCopy-->Se você copiou os binários de Licenciamento para qualquer uma das unidades locais, execute o seguinte comando:
\x64\Licensing\CitrixLicensing.exe /quiet /l install.log
1. Execute o seguinte:
<!--NeedCopy-->
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL
```
Usar 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 para SO de várias sessões:
VDAServerSetup_xxxx.exe - Agente de Entrega Virtual para SO de sessão única:
VDAWorkstationSetup_xxxx.exe - Agente de Entrega Virtual de Serviços Principais para SO de sessão única:
VDAWorkstationCoreSetup_xxxx.exe
- Agente de Entrega Virtual para SO de várias sessões:
-
Primeiro, extraia os arquivos do pacote para um diretório existente e, em seguida, execute o comando de instalação, ou simplesmente execute o pacote.
Para extrair os arquivos antes de instalá-los, use
/extractcom o caminho absoluto, por exemploC:\YourExtractFolder\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
Para executar o pacote baixado, execute seu nome:
VDAServerSetup.exe,VDAWorkstationSetup.exeouVDAWorkstationCoreSetup.exe. Use as opções válidas listadas neste artigo. -
Se você está familiarizado com o instalador completo do produto:
-
Execute o instalador autônomo
VDAServerSetup.exeouVDAWorkstationSetup.execomo se fosse o comandoXenDesktopVdaSetup.exeem tudo, exceto em seu nome. -
O instalador
VDAWorkstationCoreSetup.exeé diferente, pois suporta um subconjunto das opções disponíveis para os outros instaladores.
Lista de componentes separados por vírgulas para instalar ou remover. Os valores válidos são:
-
VDA: Agente de Entrega Virtual -
CSA: Cliente Citrix Secure Access™ -
PLUGINS: aplicativo Citrix Workspace™ para Windows -
UPL: Camada de Personalização do Usuário Citrix
Para instalar o VDA e o aplicativo Citrix Workspace para Windows, especifique /components vda,plugins ou não especifique nenhum componente.
A partir desta versão, o Citrix Device Trust, o Citrix uberAgent e o Agente Citrix Workspace Environment Management™ (WEM) são integrados à instalação padrão do VDA. Esses componentes são instalados silenciosamente como parte da configuração do VDA e não são mais gerenciados como componentes separados.
Observação:
Se uma versão autônoma existente do Citrix uberAgent® for detectada no ambiente, ela não será instalada, atualizada ou desinstalada pelo instalador.
Para instalar apenas o VDA e excluir a instalação de outros componentes Citrix, 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 ou outros componentes Citrix.
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 obter mais detalhes sobre as opções, consulte Instalar VDAs.
-
/components componente[,componente]
Lista de componentes separados por vírgulas para instalar ou remover. Os valores válidos são:
-
VDA: Agente de Entrega Virtual -
PLUGINS: aplicativo Citrix Workspace para Windows -
CSA: Cliente Citrix Secure Access -
UPL: Camada de Personalização do Usuário Citrix
-
Para instalar o VDA e o aplicativo Citrix Workspace para Windows, especifique /components vda, plugins, CSA, UPL ou não especifique nenhum componente. Se nenhum componente for especificado, apenas o VDA será instalado por padrão.
Para instalar apenas 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.
-
/onlyprereqs
Apenas os pré-requisitos para os componentes selecionados serão instalados. Nenhum componente de produto Citrix será instalado.
-
/controllers “controlador [controlador]”
FQDNs de Controladores separados por espaços 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, 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. -
/enable_hdx_udp_ports
Abre portas UDP no firewall do Windows que o transporte adaptativo HDX usa, 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 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 as portas TCP e UDP 443 para HDX™ Direct V1.
-
/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 você 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 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 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 reter 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_SECURE_DEFAULTS
Altera a configuração padrão para vários recursos de habilitado para desabilitado para uma configuração mais segura pronta para uso. Os recursos relevantes são: redirecionamento de unidade cliente, redirecionamento de pasta especial, arrastar e soltar, redirecionamento de dispositivo TWAIN cliente, redirecionamento de dispositivo USB Plug and Play cliente, redirecionamento de impressora cliente, redirecionamento de área de transferência cliente e redirecionamento de microfone cliente.
-
/enable_ss_ports
Abre portas no Firewall do Windows que são exigidas 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.
-
/SKIPHDXDRIVERCHECK
Ignora a verificação dos Drivers HDX™ para o Meta-instalador do VDA.
-
/exclude “componente”[,”componente”]
Impede a instalação de um ou mais componentes opcionais separados por vírgulas, 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 de várias sessões SO de sessão única Serviços Principais do SO de sessão única Plug-in VDA de Asserção de Identidade de Autenticação CitrixPlug-in VDA de Asserção de Identidade de Autenticação CitrixPlug-in VDA de Asserção de Identidade de Autenticação CitrixBackup e Restauração CitrixBackup e Restauração CitrixRedirecionamento de Conteúdo do Navegador CitrixCitrix deviceTRUSTCitrix deviceTRUSTCitrix deviceTRUSTuberAgentuberAgentuberAgentCliente Citrix Secure AccessCliente Citrix Secure AccessCliente Citrix Secure AccessAgente Citrix Workspace Environment ManagementAgente Citrix Workspace Environment ManagementAgente Citrix Workspace Environment ManagementRedirecionamento de Conteúdo do Navegador CitrixRedirecionamento de Conteúdo do Navegador CitrixPersonalização Citrix para App-V - VDACitrix MCS IODriverCitrix MCS IODriverServiço de Telemetria CitrixPersonalização Citrix para App-V - VDAPersonalização Citrix para App-V - VDACliente de Impressão Universal CitrixGerenciamento de Perfil CitrixGerenciamento de Perfil CitrixServiço de Captura de Log do VDA CitrixPlug-in WMI de Gerenciamento de Perfil CitrixPlug-in WMI de Gerenciamento de Perfil CitrixComponente CSECitrix Rendezvous V2Citrix Rendezvous V2Plug-in VDA do DirectorServiço de Telemetria CitrixServiço de Telemetria CitrixProvedor de Gerenciamento de MáquinaCliente de Impressão Universal CitrixCliente de Impressão Universal CitrixPlug-in de Monitoramento do VDAServiço de Captura de Log do VDA CitrixServiço de Captura de Log do VDA CitrixPlug-in Proxy WMI do VDAAgente de Atualização do VDA CitrixAgente de Atualização do VDA CitrixComponente CSEComponente CSEPlug-in VDA do DirectorPlug-in VDA do DirectorServiço de Identidade da MáquinaServiço de Identidade da MáquinaProvedor de Gerenciamento de MáquinaProvedor de Gerenciamento de MáquinaPlug-in de Monitoramento do VDACamada de Personalização do UsuárioPlug-in Proxy WMI do VDAPlug-in de Monitoramento do VDAPlug-in Proxy WMI do VDAComponente de Proteção de Aplicativos CitrixComponente de Proteção de Aplicativos CitrixComponente de Proteção de Aplicativos CitrixDriver de Filtro Citrix HyperVDriver de Filtro Citrix HyperVPersonalização Citrix para App-V - VDAPersonalização Citrix para App-V - VDAPersonalização Citrix para App-V - VDAExcluir o Gerenciamento de Perfil Citrix 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 “Ponto de extremidade”, 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 usuário 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ê especificar
/excludee/includeadditionalcom o mesmo nome de componente, esse 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. Esta opção pode ser útil ao criar uma implantação de Acesso Remoto a PC e desejar instalar outros componentes que não estão incluídos por padrão. Os valores válidos são os seguintes:
SO de várias sessões SO de sessão única Backup e Restauração CitrixBackup e Restauração CitrixCitrix MCS IODriverCitrix MCS IODriverPersonalização Citrix para App-V - VDAPersonalização Citrix para App-V - VDAGerenciamento de Perfil CitrixGerenciamento de Perfil CitrixPlug-in WMI de Gerenciamento de Perfil CitrixPlug-in WMI de Gerenciamento de Perfil CitrixCitrix Rendezvous V2Citrix Rendezvous V2Agente de Atualização do VDA CitrixAgente de Atualização do VDA CitrixFerramenta de Registro de VDA Web Socket CitrixFerramenta de Registro de VDA Web Socket CitrixServiço de Identidade da MáquinaServiço de Identidade da MáquinaCamada de Personalização do UsuárioSe 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 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 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) para provisionar VMs.
-
/websockettoken WebSocketToken
Cria um VDA Web Socket. O WebSocketToken é para o token que é exigido.
-
/websockettokenfile ArquivoContendoWebSockToken
Cria um VDA Web Socket. O ArquivoContendoWebSockToken é para o arquivo que contém o token que é exigido.
-
/websockettokenstdin <WebSocketToken
Cria um VDA de Web Socket. O <WebSocketToken refere-se ao token necessário que é passado via STDIN.
-
/no_mediafoundation_ack
Reconhece que o Microsoft Media Foundation não está instalado e que 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 foram atendidas. A maioria das edições compatíveis 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 do Registro procurada pelo Citrix Meta Installer pode não ter um valor definido. Verifique a chave do Registro
SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersionantes de iniciar o processo de instalação para confirmar que o valor existe e não está vazio. -
/nodesktopexperience
O recurso “Experiência de Área de Trabalho Aprimorada” não está mais disponível. Esta opção (e configuração de política) é ignorada, se especificada.
Válido apenas ao instalar um VDA para SO de várias sessões. Impede a habilitação do recurso “Experiência de Área de Trabalho Aprimorada”. Este recurso também é controlado pela configuração de política Citrix “Experiência de Área de Trabalho Aprimorada”.
-
/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. -
/physicalmachine
Use este argumento junto com
/remotepcpara a instalação do RemotePC. Caso contrário, o VDA pode não se comportar conforme o esperado em certos cenários de usuário. -
/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”
Se você planeja usar o protocolo Rendezvous V2 com serviços 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. Apenas proxies HTTP são suportados. O endereço ou caminho do arquivo PAC do proxy para uso com o protocolo Rendezvous. Esta linha de comando instala automaticamente o Citrix Rendezvous V2 como se
/includeadditional "Citrix Rendezvous V2"tivesse sido usado. 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 para PC” (SO de sessão única) ou conexões intermediadas (SO de várias sessões). Exclui a instalação de quaisquer componentes adicionais (consulte as listas de componentes com as opções
/excludee/includeadditional).Esta opção não é válida ao usar o instalador
VDAWorkstationCoreSetup.exe. Esse instalador exclui automaticamente a instalação desses componentes./remotepcnão é compatível com a opção/servervdi. -
/remove
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.
-
/remove_pvd_ack
Autoriza o instalador do VDA a desinstalar o Personal vDisk, se estiver instalado.
-
/removeall
Remove o VDA. Não remove o Citrix Workspace app (se instalado).
-
/REMOVEALLWITHCWA
Remove o CWA junto com o VDA.
-
/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 para SO de sessão única em uma máquina Windows de várias sessões compatível. Omita esta opção ao instalar um VDA para SO de várias sessões em uma máquina Windows de várias sessões.
Antes de usar esta opção, consulte Server VDI.
Use esta opção apenas com o instalador VDA de produto completo.
-
/site_guid guid
Identificador Globalmente Único (GUID) da Unidade Organizacional (UO) do Active Directory do site. Isso associa uma área de trabalho 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 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.
-
/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 de instalação de um VDA
Instalar um VDA com o instalador de produto completo:
O comando a seguir instala um VDA para SO de sessão única e o Citrix Workspace app no local padrão em uma VM. Este VDA será usado como uma imagem e usará o MCS para provisionar VMs. O VDA se registrará inicialmente com o Controller no servidor chamado Contr-Main no domínio mydomain. O VDA usará a camada de personalização do usuário e o 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
Instalar um VDA de SO de sessão única com o instalador autônomo VDAWorkstationCoreSetup:
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 para PC” ou VDI. O Citrix Workspace app e outros serviços não essenciais não são instalados. O endereço de um Controller é especificado, e as portas no “Serviço de Firewall do Windows” serão abertas automaticamente. O administrador lidará com as reinicializações.
VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
Personalizar um VDA
Após instalar um VDA, você pode personalizar várias configurações. No diretório \x64\XenDesktop Setup na mídia do produto, execute XenDesktopVdaSetup.exe, usando uma ou mais das seguintes opções, que são descritas em Opções de linha de comando para instalar um VDA.
-
/reconfigure(obrigatório ao personalizar um VDA) -
/hou/help /quiet/noreboot/controllers/portnumber porta/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 uma área de trabalho aos usuários até que se registre em um Delivery Controller.
Para saber mais sobre os métodos de registro de VDA e como solucionar problemas de registro, consulte Registro de VDA.
Opções de linha de comando para instalar um Universal Print Server
A opção a seguir é válida com o comando XenDesktopPrintServerSetup.exe.
- /enable_upsserver_port
Quando esta opção não é especificada, o instalador exibe a página “Firewall” da interface gráfica. Selecione “Automaticamente” para que o instalador adicione automaticamente as regras de firewall do Windows, ou “Manualmente” para permitir que o administrador configure o firewall manualmente.
Após instalar o software em seus servidores de impressão, configure o Universal Print Server usando as orientações em Citrix Universal Print Server (UPS).
Opções de linha de comando para instalar o Secure Private Access
As opções a seguir são válidas com ambos:
- Instalador CVAD:
XenDesktopSPASetup.exe - Instalador SPA local:
SecurePrivateAccessSetup_XXXX.exe
-
/enable_spa_ports
Abre as 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 você estiver usando um firewall diferente ou nenhum firewall, 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 a ajuda do comando
-
/noreboot
Impede uma reinicialização após a instalação. O Secure Private Access não pode ser usado antes de uma reinicialização.
-
/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.
-
/remove
Remove o Secure Private Access.
Para obter mais detalhes sobre as opções, consulte Instalador do Secure Private Access.
Mais informações
Para obter informações sobre como a Citrix relata o resultado das instalações de componentes, consulte Códigos de retorno de instalação da Citrix. ```
Neste artigo
- Introdução
- Usar o instalador completo do produto
- Opções de linha de comando para instalar componentes principais
- Exemplos de instalação de componentes principais
- Usar um instalador VDA autônomo
- Opções de linha de comando para instalar um VDA
- Exemplos de instalação de um VDA
- Personalizar um VDA
- Solucionar problemas de VDAs
- Opções de linha de comando para instalar um Universal Print Server
- Opções de linha de comando para instalar o Secure Private Access
- Mais informações