Citrix Virtual Apps and Desktops

Instalar usando a linha de comando

November 5, 2024

Contribuição de:

C C

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 Citrix Licensing Data.

Introdução

Este artigo aplica-se à instalação de componentes em máquinas com sistemas operacionais Windows. Para obter informações sobre sistemas operacionais VDAs para Linux, consulte Linux Virtual Delivery Agents.

Este artigo descreve como emitir comandos de instalação de produto. Antes de iniciar qualquer instalação, revise Preparar para instalar. Este 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 a opção Executar como administrador. Para obter mais informações, consulte a documentação sobre comandos da Microsoft.

Como complemento ao uso dos comandos de instalação diretamente, 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 lhe fornecerá 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 de produto completo

Para acessar a interface da linha de comando do instalador do produto completo:

Baixe o pacote de produtos da Citrix. As credenciais da conta da 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 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 os componentes principais: Execute XenDesktopServerSetup.exe, com as opções listadas em Opções de linha de comando para instalar os 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 pasta x64 > 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 o uso da 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.exe na pasta x64 > 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 opções de parâmetros a seguir 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.

/ceipoptina ceipoptina [,ceipoptina]…

Permite a coleta de dados do Call Home e do Programa de Aperfeiçoamento da Experiência do Usuário (CEIP). Os valores válidos são:
- DIAGNÓSTICO: Escolha esse valor para permitir que o Citrix Licensing colete dados do Call Home.
- ANÔNIMO: Escolha esse valor para permitir que o Citrix Licensing colete dados não identificados do CEIP (que não identificam os usuários).
- NONE: Escolha esse valor para desativar a coleta de dados do CEIP pelo Citrix Licensing.
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 do CEIP, consulte Citrix Licensing Customer Experience Improvement Program.

Para obter mais detalhes sobre os dados do CEIP, consulte Citrix Licensing CEIP data elements.

Para obter mais detalhes sobre os dados de licenciamento do License Server, consulte Citrix Licensing Data.
/components componente [,componente]…

Lista de componentes separados por vírgula para instalar ou remover. Os valores válidos são:
- CONTROLLER: Controlador
- DESKTOPSTUDIO: Estúdio
- WEBSTUDIO: Estúdio Web
- DESKTOPDIRECTOR: Diretor
- LICENSESERVER: Servidor de licenças Citrix
- SECUREPRIVATEACCESS: Acesso privado seguro
Se essa opção for omitida, todos os componentes serão instalados (ou removidos, se a opção /remove também for especificada).

(Nas 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).
/configure_firewall

Abre todas as portas no firewall do Windows usadas pelos componentes que estão sendo instalados, se o Serviço do Firewall do Windows estiver em execução, mesmo que o firewall não esteja ativado. Se você estiver usando um firewall de terceiros, ou se não estiver usando nenhum firewall, deverá abrir as portas manualmente.
/disableexperiencemetrics

Impede o carregamento automático de análises coletadas durante a instalação, atualização ou remoção para a Citrix.
/exclude “feature“\ [,”feature“]

Impede a instalação de um ou mais recursos, serviços ou tecnologias separados por vírgula, cada qual entre aspas retas normais. Os valores válidos são:
- “Local Host Cache Storage (LocalDB)”: Impede a instalação do banco de dados usado para o Local Host Cache. Esta opção não afeta se a instalação do SQL Server Express é realizada para usar como banco de dados do site ou nã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 à RAM insuficiente). Para obter mais informações, consulte Verificação de hardware.
/ignore\ _site\ _teste\ _falha

Válido somente durante a atualização do Controller. Normalmente, as falhas de teste do site são ignoradas e a atualização prossegue. Se omitido (ou definido como false), qualquer falha de teste do site faz com que o instalador falhe, sem executar a atualização. Padrão = false

Durante uma atualização, esta opção é ignorada se uma versão do SQL Server não suportada for detectada. Para obter detalhes, consulte Verificação da 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 a cria. Padrão = TEMP%\ Citrix\XeNDesktop Installer
/no_remote_assistance

Válido somente ao instalar o Director. Desativa 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, a reinicialização não é ativada por padrão.)
/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.
/nosql

Impede a instalação do Microsoft SQL Server Express no servidor em que você está instalando o Controller. Se esta opção for omitida, o SQL Server Express é instalado para uso como o banco de dados do site.

Essa 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.
/SKIPHDXDRIVERCHECK

Ignora a verificação dos drivers HDX no Meta-instalador do VDA.
/sendexperiencemetrics

Envia automaticamente análises coletadas durante a instalação, atualização ou remoção para a Citrix. Se essa opção for omitida (ou /disableexperiencemetrics for especificada), as análises serão coletadas localmente, mas não enviadas automaticamente.
/tempdir diretório

Diretório que mantém os 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\XeConfiguração do nDesktop\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 a comunicação de componentes são abertas automaticamente.

\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /controlador de componentes,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 a comunicação de componentes são abertas automaticamente.

\x64\XeConfiguração do nDesktop XenDesktopServerSetup.exe /xenapp /components controller,secureprivateaccess /configure_firewall

Usar um instalador autônomo de VDA

As credenciais da conta da 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 de 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 do OS Core Services de sessão única: VDAWorkstationCoreSetup_xxxx.exe
Extraia os arquivos do pacote para um diretório existente primeiro e, em seguida, 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 exemplo C:\YourExtractFolder\VDAWorkstationCoreSetup.exe /extract %temp%\ CitrixVDAInstallMedia. O diretório deve existir. Caso contrário, a extração 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
Para executar o pacote baixado, execute seu nome: VDAServerSetup.exe, VDAWorkstationSetup.exeou VDAWorkstationCoreSetup.exe. Use as opções válidas listadas neste artigo.

Se você estiver familiarizado com o instalador do produto completo:

Execute o instalador autônomo VDAServerSetup.exe ou VDAWorkstationSetup.exe como se fosse o comando XenDesktopVdaSetup.exe em tudo, exceto no nome.
O instalador VDAWorkstationCoreSetup.exe é diferente, pois suporta um subconjunto das opções disponíveis para os outros instaladores.

opções de linha de comando para instalar um VDA

As opções a seguir são válidas com um ou mais dos seguintes comandos (instaladores): VDAServerSetup_xxxx.exe, VDAWorkstationSetup_xxxx.exee VDAWorkstationCoreSetup_xxxx.exe.

Para obter mais detalhes sobre as opções, consulte Instalar VDAs.

/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 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.

Essa opção não é válida ao usar o instalador VDAWorkstationCoreSetup_xxxx.exe . Esse instalador não pode instalar o aplicativo Citrix Workspace.
/controllers “controlador \ [controlador]”

FQDNs separados por espaço de Controllers com os quais o VDA pode se comunicar, entre aspas retas normais. Não especifique as opções /site_guid e /controllers .
/disableexperiencemetrics

Impede o carregamento automático de análises coletadas durante a instalação, atualização ou remoção para a Citrix.
/habilitar\ _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 que o transporte adaptativo HDX usa, especifique a opção /enable_hdx_udp_ports , além dessa opção /enable_hdx_ports .
/habilitar\ _hdx\ _udp\ _portas

Abre portas UDP no firewall do Windows que o transporte adaptativo HDX usa, 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 portas extras que o VDA usa, especifique a opção /enable_hdx_ports , além dessa opção /enable_hdx_udp_ports .
/enable_hdx_tls_dtls

Abre as portas TCP e UDP 443 para HDX Direct V1.
/habilitar transporte em\ _tempo real\ _

Ativa ou desativa o uso de UDP para pacotes de áudio (transporte de áudio em tempo real para áudio). Ativar 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.
/enable_remote_assistance

Ativa 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 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:
- /enablerestorecleanup instrui o instalador a remover o ponto de restauração.
- /enablerestore instrui o instalador a reter 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\ _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 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 de SO de sessão única
`Componente de proteção de aplicativo Citrix`	`Componente de proteção de aplicativo Citrix`	`Componente de proteção de aplicativo Citrix`
`Plug-in de Asserção de Identidade de Autenticação Citrix VDA`	`Plug-in de Asserção de Identidade de Autenticação Citrix VDA`	`Plug-in de Asserção de Identidade de Autenticação Citrix VDA`
`Citrix Backup and Restore`	`Citrix Backup and Restore`
`Redirecionamento de conteúdo do navegador Citrix`	`Redirecionamento de conteúdo do navegador Citrix`	`Redirecionamento de conteúdo do navegador Citrix`
`Driver de filtro Citrix HyperV`	`Driver de filtro Citrix HyperV`
`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`
`Serviço de captura de log Citrix Vda`	`Serviço de captura de log Citrix Vda`	`Serviço de captura de log Citrix Vda`
`Citrix VDA Upgrade Agent`	`Citrix VDA Upgrade Agent`
`Componente CSE`	`Componente CSE`	`Componente CSE`
`Plug-in Diretor VDA`	`Plug-in Diretor VDA`	`Plug-in Diretor VDA`
`Machine Identity Service`	`Machine Identity Service`
`Provedor de gerenciamento de máquinas`	`Provedor de gerenciamento de máquinas`	`Provedor de gerenciamento de máquinas`
	`User Personalization Layer`
`Plug-in do monitor VDA`	`Plug-in do monitor VDA`	`Plug-in do monitor VDA`
`Plug-in de proxy VDA WMI`	`Plug-in de proxy VDA WMI`	`Plug-in de proxy VDA WMI`

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 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 de gerenciamento de perfil de usuário 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ê especificar /exclude e /includeadditional com o mesmo nome de componente, esse componente não será instalado.

Essa opção não é válida ao usar o instalador VDAWorkstationCoreSetup.exe . Esse instalador exclui automaticamente muitos destes itens.

/h ou /help

Exibe a ajuda do comando.

/includecomponente “adicional“\ [,”component“]

Inclui a instalação de um ou mais componentes opcionais separados por vírgula, cada qual entre aspas retas normais. Esta opção é útil quando você estiver criando uma implantação do Remote PC Access 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`
`Ferramenta de registro Citrix Web Socket Vda`	`Ferramenta de registro Citrix Web Socket Vda`
`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.
/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 para ser usada para criar outras máquinas. Essa opção é equivalente a /mastermcsimage.

Essa opção não é válida ao usar o instalador VDAWorkstationCoreSetup_xxxx.exe .
/mastermcsimage

Especifica que a máquina será usada como uma imagem com Machine Creation Services. Essa 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) para provisionar VMs.
/websockettoken websocketToken

Cria um VDA do Web Socket. 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 essa 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 vem com o Media Foundation já instalado, exceto as edições N. Se você habilitar o Windows Features > Media Features 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.
/nodesktopexperience

O recurso Enhanced Desktop Experience não está mais disponível. Esta opção (e configuração de política) é ignorada, se especificada.

Válido somente ao instalar um VDA de 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.
/physicalmachine

Use esse argumento junto com /remotepc para instalação do RemotePC. Caso contrário, o VDA pode não se comportar conforme o esperado em determinados cenários do usuário.
/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”

Se você planeja usar o protocolo Rendezvous com o Gateway Service, o VDA Upgrade Service etc. em seu ambiente e tem um proxy não transparente em sua rede para conexões de saída, especifique o proxy aqui. Somente proxies HTTP são aceitos. 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 do endereço proxy: http://<url-or-ip>:<port>
- Formato de arquivo PAC: http://<url-or-ip>:<port>/<path>/<filename>.pac
/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 usadas com as opções /portnumber, /controllersou /enable_hdx_ports . Se você especificar essa opção sem especificar também a opção /quiet , a interface gráfica para personalizar o VDA será iniciada.
/remotepc

Válido somente para implantações de Remote PC Access (SO de sessão única) ou conexões agenciadas (SO multissessão). Exclui a instalação de quaisquer componentes adicionais (consulte as listas de componentes com as opções /exclude e /includeadditional ).

Essa opção não é válida ao usar o instalador VDAWorkstationCoreSetup.exe . Esse instalador exclui automaticamente a instalação destes componentes.

/remotepc não é compatível com a opção /servervdi .
/remove

Remove os componentes especificados com a opção /components .
/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.
/removeall

Remove o VDA. Ele não remove o aplicativo Citrix Workspace (se instalado).
/REMOVA TUDO COM CWA

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 essa opção for omitida (ou a opção /disableexperiencemetrics 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 uma máquina multissessão Windows suportada. Omita esta opção quando instalar um VDA de SO multissessão em uma máquina multissessão Windows.

Antes de usar essa opção, consulte Server VDI.

Use esta opção somente com o instalador de VDA de produto completo.
/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 no Studio. Não especifique as opções /site_guid e /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 de instalação de um VDA

Instalar um VDA com o instalador de produto completo:

O comando a seguir instala um VDA de SO de sessão única e o aplicativo Citrix Workspace no local padrão em uma VM. Este VDA será usado como uma imagem e usa o MCS para provisionar VMs. O VDA será registrado 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 a Assistência Remota do Windows.

\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "camada de personalização do usuário" /mastermcsimage /enable_remote_assistance

Instale um VDA de SO de sessão única com o instalador autônomo VDAWorkstationCoreSetup:

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 VDI. O aplicativo Citrix Workspace e outros serviços não principais não são instalados. O endereço de um Controller é especificado e as portas no Serviço do 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

Depois de instalar um VDA, você pode personalizar várias configurações. No diretório \x64\XeNDesktop Setup na mídia do produto, execute XenDesktopVdaSetup.exeusando 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 /help
/quieto
/noreboot
/controllers
/portnumber porta
/enable_hdx_ports

Solucionar problemas de VDAs

Na tela do Studio de um grupo de entrega, a entrada Installed VDA version no painel Details pode não refletir 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.
Depois que um VDA é instalado, 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 Servidor de Impressão Universal

A opção a seguir é válida com o comando XenDesktopPrintServerSetup.exe .

/enable_upsserver_port

Quando esta opção não for especificada, o instalador exibe a página de Firewall a partir da interface gráfica. Selecione Automatically para que o instalador adicione automaticamente as regras de firewall do Windows, ou Manually 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 acesso privado seguro

As opções a seguir são válidas com:

Instalador do CVAD: XenDesktopSPASetup.exe
Instalador local do SPA: SecurePrivateAccessSetup_XXXX.exe

/enable_spa_ports

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 se não estiver usando um firewall), você deve configurar o firewall manualmente. Para obter informações sobre portas, consulte Network ports.
/nosql

Impede a instalação do Microsoft SQL Server Express no servidor em que você está instalando o Secure Private Access. Se esta opção for omitida, o SQL Server Express é instalado para uso como o 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 até depois 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 acesso privado seguro.

Para obter mais detalhes sobre as opções, consulte Secure Private Access installer.

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.

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

Instalar usando a linha de comando

November 5, 2024

Contribuição de:

C C

November 5, 2024

Contribuição de:

C C

Neste artigo

Introdução
Usar o instalador de produto completo
Opções de linha de comando para instalar componentes principais
Exemplos de instalação de componentes principais
Usar um instalador autônomo de VDA
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 Servidor de Impressão Universal
Opções de linha de comando para instalar um acesso privado seguro
Mais informações

Isso foi útil?