Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Instalar VDAs usando o SCCM

January 23, 2026
Contribuição de: 
C

Visão geral

O Microsoft Endpoint Configuration Manager, anteriormente System Center Configuration Manager (SCCM), é um produto Windows que permite o gerenciamento, a implantação e a segurança de dispositivos e aplicativos em toda 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 o 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 usar o 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 do VDA é executada pela primeira vez em uma máquina, o instalador do VDA usado é copiado para essa máquina. Para obter mais informações sobre a instalação do VDA, consulte Instaladores.

O SCCM Task Sequencer gerencia todas as reinicializações necessárias.

Etapas principais para implantar o VDA usando o SCCM

As etapas a seguir descrevem como implantar o VDA usando o SCCM na máquina virtual.

  1. Instalar o VDA.
  2. Criar uma unidade organizacional (OU).
  3. Verificar as máquinas.
  4. Usar o VDA para distribuir conteúdo.

Etapa 1: Instalar o VDA

Após identificar todos os pré-requisitos, use o SCCM Task Sequencer para concluir as seguintes tarefas:

  1. 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:

    Ao atualizar um VDA, a máquina na qual ele está instalado deve estar em modo de manutenção, sem sessões.

  2. Quando uma instalação do VDA é executada pela primeira vez em uma máquina, o instalador do VDA usado é copiado para essa máquina.
    • Ao usar um instalador do VDA diferente de VDAWorkstationCoreSetup_XXXX.exe, o instalador do VDA é copiado para %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
    • Ao usar VDAWorkstationCoreSetup_XXXX.exe, o instalador do VDA é copiado para %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe.

  3. O local do diretório do instalador do VDA também é armazenado no registro HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”.

  4. Adicione as opções de linha de comando /NOREBOOT, /NORESUME e /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 a reinicialização automática do instalador do VDA. O SCCM aciona as reinicializações quando necessário.
    • /NORESUME: Geralmente, quando uma reinicialização é necessária durante a instalação, o instalador do VDA define uma chave de registro runonce (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). O Windows usa a chave para abrir o instalador do VDA quando a máquina é reiniciada. Isso é um problema para o SCCM, porque o SCCM não pode monitorar a instalação e capturar o código de saída.

Etapa 2: Criar uma unidade organizacional (OU)

  1. 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 Computadores. Mova as máquinas virtuais para a pasta SCCM. Exemplo: WIN10EN-BB80MJ4.cseblr.com W2K19ST-EBPR3UG.cseblr.com

    VDA do SCCM

  2. No Microsoft Configuration Manager, vá para \Administration\Overview\Hierarchy Configuration\Discovery Methods\.

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

  4. Clique no ícone ícone para selecionar novos contêineres.

  5. Na seção Location, adicione o Path onde suas máquinas virtuais SCCM estão localizadas.

  6. Vá para \Administration\Overview\Site Configuration\Sites e clique com o botão direito do mouse no VDA do SCCM.

  7. Selecione Client Installation Settings > Client Push Installation. A janela Client Push Installation Properties é aberta.

  8. Assim que as VMs forem definidas como Enabled, você poderá ver a lista de VMs conforme ilustrado nas imagens a seguir.

    SCCM

    SCCM-2

  9. Crie a Device collection para criar a OU. Insira o Name do Collection Name.

    Coleção de dispositivos

  10. Siga as instruções do assistente.

    Regras de associação

    A OU é criada.

    Criação de OU

  11. Adicione as VMs criadas à Device Collection recém-criada.

    1. Clique com o botão direito do mouse na VM. Selecione Add Selected Items > Add Selected Items to Existing Device Collection.

      Adicionar item

    2. Na janela Select Collection, selecione o nome do dispositivo necessário. Neste exemplo, é Devices-SCCM.

      Lista de dispositivos

    Devices-SCCM está listado em Assets and Compliance > Overview > Device Collections.

    Dispositivo listado

  12. Selecione Install Client no Device Collector.

    Instalar cliente

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

    Site de instalação

  14. Siga as instruções do assistente. O Install Configuration Manager Client Wizard é concluído com sucesso.

    Instalação concluída

Para obter informações detalhadas, consulte Gerenciar coleções na documentação da Microsoft.

Etapa 3: Verificar as máquinas

  1. Na máquina cliente, verifique se o cliente está instalado, verificando se o processo CCMExec está em execução.

    CCMexe.exe

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

  1. Criar um pacote

  2. Distribuir conteúdo

Criar um pacote

  1. Para criar um pacote, clique com o botão direito do mouse no VDA desejado e clique em Create Package.

    Criar pacote

  2. Especifique o local dos arquivos de origem para este pacote clicando em Browse.

    Procurar pacote

  3. Selecione o tipo de pacote desejado.

    Assistente de criação de pacote e programa

  4. Insira o Name do pacote e a Command line.

    Especificar detalhes do pacote

  5. Clique em Next.

    Pacote bem-sucedido

Para obter informações detalhadas, consulte Pacotes e programas no Configuration Manager na documentação da Microsoft.

Distribuir conteúdo

  1. Clique com o botão direito do mouse no nome do pacote que você criou.

  2. Selecione Distribute Content.

    Distribuir conteúdo

  3. Na janela Distribute Content Wizard, selecione o local dos arquivos de origem para o pacote que você criou. Neste exemplo, é 2019-SCCM. Clique em Next.

    Especificar local

  4. Verifique se o Package (neste exemplo, Zodiac) está disponível para implantação.

    Verificação

    A imagem a seguir ilustra que o pacote está disponível para implantação.

    Pacote 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 o SCCM

O exemplo a seguir mostra a sequência de instalação.

  1. Reiniciar Computador: Prepare a máquina reiniciando-a.

    Reiniciar Computador

  2. Instalar VDA Primeira Tentativa: Inicie a instalação do VDA.

    1. Adicione as opções /quiet, /noreboot e /noresume às suas opções de linha de comando.

    2. Execute o instalador do VDA de sua escolha (imagem local ou um dos instaladores mínimos).

      Instalar VDA Primeira Tentativa

    3. O SCCM deve capturar o código de retorno.

      • Se o código de retorno for 0 ou 8, a instalação estará concluída e uma reinicialização será necessária.

        SCCM captura código de retorno

      • Se um código de retorno for 3, reinicie a máquina e, em seguida, passe o controle para Instalar VDA Segunda Tentativa.

        Reiniciar máquina

  3. Instalar VDA Segunda Tentativa: Continue a instalação do VDA.

    1. Após a Instalar VDA Primeira Tentativa, se o arquivo %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml existir, a instalação não estará concluída e deverá ser continuada após a conclusão da reinicialização.

      Instalar VDA Segunda Tentativa

    2. A Instalar VDA Segunda Tentativa se repete até que o arquivo %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml nã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 a INSTALAR VDA SEGUNDA TENTATIVA deve relatar um erro e parar.

    3. Retome a instalação do VDA executando o instalador do VDA apropriado (XenDesktopVdaSetup.exe na maioria dos casos, ou XenDesktopRemotePCSetup.exe se VDAWorkstationCoreSetup_XXXX.exe foi usado) do diretório %programdata%\ Citrix\XenDesktopSetup\ sem parâmetros de linha de comando. (O instalador do VDA usa os parâmetros que salvou durante a primeira execução do instalador.)

      Editor de Sequência de Tarefas de Atualização

    4. Observe o código de retorno do instalador do VDA.

      • 0 ou 8: Sucesso, instalação concluída, reinicialização necessária.

        Instalação concluída com sucesso

      • 3: A instalação não está concluída. Reinicie a máquina e repita a INSTALAR VDA SEGUNDA TENTATIVA até que o arquivo %programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml não exista ou até que um 0 ou 8 seja retornado. Trate qualquer outro código de retorno como um erro, e a INSTALAR VDA SEGUNDA TENTATIVA deve relatar um erro e terminar.

Para obter mais informações sobre códigos de retorno, consulte Códigos de retorno de instalação da Citrix.

Exemplos de comandos de instalação do VDA

As opções de instalação disponíveis variam, dependendo do instalador usado. Consulte os artigos a seguir para obter detalhes das opções de 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

Instalar VDAs usando o SCCM
January 23, 2026
Contribuição de: 
C
January 23, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.