Instalar VDAs usando SCCM
Visão geral
O Microsoft Endpoint Configuration Manager, anteriormente System Center Configuration Manager (SCCM), é um produto Windows que permite o gerenciamento, implantação e segurança de dispositivos e aplicativos em uma empresa.
Observação:
O artigo a seguir descreve apenas recomendações baseadas em como a Citrix® testou o ambiente. Você pode personalizar essas etapas de acordo com suas necessidades. A Citrix não se responsabiliza por quaisquer atualizações ou ajustes necessários para que isso se adapte às necessidades do cliente.
Recomendações
-
Para implantar com sucesso um Virtual Delivery Agent (VDA) usando SCCM ou ferramentas de distribuição de software semelhantes, a Citrix recomenda usar o instalador do VDA em uma sequência de etapas.
-
A Citrix não recomenda o uso do VDA Cleanup Utility como parte de uma instalação ou atualização do VDA. Use o VDA Cleanup Utility apenas no caso limitado em que o instalador do VDA falhou anteriormente.
Antes de começar
O número de reinicializações necessárias durante a instalação do VDA depende do ambiente. Por exemplo:
-
Uma reinicialização pode ser necessária para atualizações pendentes ou reinicializações de instalações de software anteriores.
-
Arquivos previamente bloqueados por outros processos podem precisar de atualizações, forçando uma reinicialização extra.
-
Alguns componentes opcionais no instalador do VDA (como Citrix Profile Management e Citrix Files) podem exigir uma reinicialização.
-
Ao atualizar um VDA, a máquina na qual ele está instalado deve estar em modo de manutenção, sem sessões.
-
Quando uma instalação de VDA é executada pela primeira vez em uma máquina, o instalador de VDA usado é copiado para essa máquina. Para obter mais informações sobre a instalação do VDA, consulte Instaladores.
O Sequenciador de Tarefas do SCCM gerencia todas as reinicializações necessárias.
Etapas principais para implantar o VDA usando SCCM
As etapas a seguir descrevem como implantar o VDA usando SCCM na máquina virtual.
Etapa 1: Instalar o VDA
Após identificar todos os pré-requisitos, use o Sequenciador de Tarefas do SCCM para concluir as seguintes tarefas:
-
Instale o VDA a partir de uma cópia acessível da mídia de instalação ou de um dos instaladores autônomos do VDA:
-
VDAWorkstationSetup_XXXX.exe -
VDAServerSetup_XXXX.exe -
VDAWorkstationCoreSetup_XXXX.exe
Para obter mais informações sobre os instaladores do VDA, consulte Instaladores.Observação:Quando você atualiza um VDA, a máquina na qual ele está instalado deve estar no modo de manutenção, sem sessões. -
-
Quando uma instalação de VDA é executada pela primeira vez em uma máquina, o instalador de VDA que está sendo usado é copiado para essa máquina.
-
Quando você usa um instalador VDA diferente de
VDAWorkstationCoreSetup_XXXX.exe, o instalador VDA é copiado para%ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe. -
Quando você usa
VDAWorkstationCoreSetup_XXXX.exe, o instalador VDA é copiado para%ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe..
-
-
O local do diretório do instalador de VDA também é armazenado no registro
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”. -
Adicione as opções de linha de comando
/NOREBOOT,/NORESUMEe/QUIETàs suas opções de linha de comando.-
/QUIET: Não mostre a interface do usuário durante a instalação, para que o SCCM tenha controle do processo de instalação. -
/NOREBOOT: Suprima o instalador de VDA de reiniciar automaticamente. O SCCM aciona reinicializações quando necessário. -
/NORESUME: Geralmente, quando uma reinicialização é necessária durante a instalação, o instalador VDA define uma chave de registro runonce (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). O Windows usa a chave para abrir o instalador VDA quando a máquina é reiniciada. Isso é um problema para o SCCM, porque o SCCM não consegue monitorar a instalação e capturar o código de saída.
-
Etapa 2: Criar uma unidade organizacional (OU)
-
Crie duas máquinas virtuais ingressadas no domínio que você deseja adicionar à OU. Quando as máquinas virtuais são criadas inicialmente, elas estão na pasta Computers. Mova as máquinas virtuais para a pasta SCCM. Exemplo: WIN10EN-BB80MJ4.cseblr.com W2K19ST-EBPR3UG.cseblr.com

-
No Microsoft Configuration Manager, vá para
\Administration\Overview\Hierarchy Configuration\Discovery Methods\. -
Clique em Active Directory System Discovery e selecione a caixa de seleção Enable Active Directory System Discovery para habilitar a descoberta automática das máquinas virtuais recém-criadas.
-
Clique no ícone
para selecionar novos contêineres.
-
Na seção Location, adicione o Path onde suas máquinas virtuais SCCM estão localizadas.
-
Vá para
\Administration\Overview\Site Configuration\Sitese clique com o botão direito do mouse no VDA SCCM. -
Selecione Client Installation Settings > Client Push Installation. A janela Client Push Installation Properties é aberta.
-
Depois que as VMs são definidas como
Enabled, você pode ver a lista de VMs conforme ilustrado nas imagens a seguir.

-
Crie a Coleção de dispositivos para criar a OU. Insira o Nome da Coleção.

-
Siga as instruções do assistente.
A OU é criada.
-
Adicione as VMs criadas à Coleção de Dispositivos recém-criada.
-
Clique com o botão direito na VM. Selecione Adicionar Itens Selecionados > Adicionar Itens Selecionados à Coleção de Dispositivos Existente.

-
Na janela Selecionar Coleção, selecione o nome do dispositivo necessário. Neste exemplo, é
Devices-SCCM.
Devices-SCCMestá listado em Ativos e Conformidade > Visão Geral > Coleções de Dispositivos.
-
-
Selecione Instalar Cliente em Coletor de Dispositivos.

-
Selecione o Site de instalação necessário.

-
Siga as instruções do assistente. O Assistente de Instalação do Cliente do Configuration Manager foi concluído com êxito.

Para obter informações detalhadas, consulte Gerenciar coleções na documentação da Microsoft.
Etapa 3: Verificar as máquinas
-
Na máquina cliente, verifique se o cliente está instalado, verificando se o processo
CCMExecestá em execução.
-
Verifique se o Cliente está em execução para as VMs no SCCM.
Etapa 4: Usar o VDA para distribuir conteúdo
As etapas a seguir descrevem como você pode usar o VDA implantado para distribuir conteúdo nas máquinas virtuais associadas.
Criar um pacote
-
Para criar um pacote, clique com o botão direito no VDA desejado e clique em Criar Pacote.

-
Especifique o local dos arquivos de origem para este pacote clicando em Procurar.

-
Selecione o tipo de pacote desejado.

-
Insira o Nome do pacote e a Linha de comando.

-
Clique em Avançar.

Para obter informações detalhadas, consulte Pacotes e programas no Configuration Manager na documentação da Microsoft.
Distribuir conteúdo
-
Clique com o botão direito no nome do pacote que você criou.
-
Selecione Distribuir Conteúdo.

-
Na janela Assistente de Distribuição de Conteúdo, selecione o local dos arquivos de origem para o pacote que você criou. Neste exemplo, é
2019-SCCM. Clique em Avançar.
-
Verifique se o Pacote (neste exemplo,
Zodiac) está disponível para implantação.
A imagem a seguir ilustra que o pacote está disponível para implantação.
Para obter informações detalhadas, consulte Implantar e gerenciar conteúdo para o Configuration Manager na documentação da Microsoft.
Exemplo de sequência de instalação usando SCCM
O exemplo a seguir mostra a sequência de instalação.
-
Reiniciar Computador: Prepare a máquina reiniciando-a.

-
Instalar VDA Primeira Tentativa: Inicie a instalação do VDA.
-
Adicione as opções
/quiet,/noreboote/noresumeàs suas opções de linha de comando. -
Execute o instalador do VDA de sua escolha (imagem local ou um dos instaladores mínimos).

-
O SCCM deve capturar o código de retorno.
-
Se o código de retorno for 0 ou 8, a instalação estará completa e será necessário reiniciar.

-
Se o código de retorno for 3, reinicie a máquina e, em seguida, passe o controle para Install VDA Second Attempt.

-
-
-
Install VDA Second Attempt: Continue a instalação do VDA.
-
Após Install VDA First Attempt, se o arquivo
%programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlexistir, a instalação não estará completa e deverá ser continuada após a conclusão da reinicialização.
-
Install VDA Second Attempt se repete até que o arquivo
%programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlnão exista ou um código de retorno diferente de 0 ou 8 seja retornado. Trate qualquer outro código de retorno como um erro, e INSTALL VDA SECOND ATTEMPT deve relatar um erro e parar. -
Retome a instalação do VDA executando o instalador VDA apropriado (
XenDesktopVdaSetup.exepara a maioria dos casos, ouXenDesktopRemotePCSetup.exeseVDAWorkstationCoreSetup_XXXX.exefoi usado) a partir do diretório do arquivo%programdata%\ Citrix\XenDesktopSetup\sem parâmetros de linha de comando. (O instalador VDA usa os parâmetros que salvou durante a primeira execução do instalador.)
-
Observe o código de retorno do instalador VDA.
-
0 ou 8: Sucesso, instalação concluída, reinicialização necessária.

-
3: A instalação não está completa. Reinicie a máquina e repita INSTALL VDA SECOND ATTEMPT até que o arquivo
%programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlnão exista ou até que um 0 ou 8 seja retornado. Trate qualquer outro código de retorno como um erro, e INSTALL VDA SECOND ATTEMPT deve relatar um erro e terminar.
-
-
Para obter mais informações sobre códigos de retorno, consulte Códigos de retorno de instalação do Citrix.
Exemplos de comandos de instalação do VDA
As opções de instalação disponíveis variam, dependendo do instalador utilizado. Consulte os seguintes artigos para obter detalhes sobre as opções de linha de comando.
-
Instalar usando a linha de comando
Comandos de instalação para Acesso Remoto a PC
-
O comando a seguir usa o instalador VDA principal de sessão única (
VDAWorkstationCoreSetup.exe):VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot -
O comando a seguir usa o instalador VDA completo de sessão única (
VDAWorkstationSetup.exe):VDAWorkstationSetup.exe /quiet /remotepc /physicalmachine /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot
Comando de instalação para VDI dedicado
-
O comando a seguir usa o instalador VDA completo de sessão única (
VDAWorkstationSetup.exe):VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot