Você pode incluir propriedades específicas ao instalar silenciosamente o Horizon Agent para Windows a partir da linha de comando. Você deve usar um formato PROPERTY=value para que o Microsoft Windows Installer (MSI) possa interpretar as propriedades e os valores. Uma atualização silenciosa usa os mesmos comandos de instalação. Você também pode modificar os componentes Horizon Agent já instalados silenciosamente.
A tabela a seguir mostra as propriedades de instalação silenciosa Horizon Agent que você pode usar na linha de comando.
Propriedade MSI | Descrição | Valor padrão |
---|---|---|
ENABLE_UNC_REDIRECTION | Especifica se o recurso Redirecionamento de Caminho UNC está instalado. Um valor de 1 instala o recurso. Você deve usar as configurações de política de grupo para configurar quais UNCs redirecionar. Consulte "Configurando o redirecionamento de caminho UNC" no documento Recursos e GPOs da Área de Trabalho Remota Horizon. Essa propriedade MSI é opcional. |
0 |
HORIZON_MONITOR_ENABLED | Especifica se o modo de monitoramento do Horizon deve ser ativado ou desativado. Esse sinalizador funcionará somente se você tiver o VMware Horizon Cloud Service - next-gen instalado em seu ambiente. Um valor de 1 ativa o modo de monitoramento do Horizon. Um valor de 0 desativa o monitoramento do Horizon. |
0 |
IGNORE_DOTNET_CHECK | Determina se o instalador verifica se há uma versão mínima do .NET. Por padrão, quando Horizon Performance Tracker é selecionado, o instalador realiza uma pré-verificação para confirmar se o .NET 4.6.2 ou posterior está instalado e, se não estiver, interromperá o processo de instalação. Um valor de 1 cancela essa pré-verificação. Um valor de 0 permite que a pré-verificação prossiga. |
%ProgramFiles%\ VMware \}\ VMware View \}\Agent |
INSTALLDIR | Caminho e pasta em que o software Horizon Agent está instalado. Por exemplo: INSTALLDIR=""D:\abc\my folder"" Os conjuntos de duas aspas duplas que incluem o caminho permitem que o instalador do MSI ignore o espaço no caminho. Essa propriedade MSI é opcional. |
|
RDP_CHOICE | Determina se o Protocolo de Área de Trabalho Remota (RDP) deve ser habilitado na área de trabalho. Um valor de 1 ativa o RDP. Um valor de 0 deixa a configuração RDP desativada. Essa propriedade MSI é opcional. |
1 |
SUPPRESS_RUNONCE_CHECK | Ignora tarefas de atualização pendentes Windows agendadas na próxima reinicialização do sistema operacional nas chaves HKLM\SOFTWARE\Microsoft\ Windows \}\CurrentVersion\RunOnce e RunOnceEx. O uso desse sinalizador permite a instalação simultânea, mas não garante o resultado da instalação quando as atualizações do sistema afetam as Horizon Agent dependências de tempo de execução. Essa propriedade MSI é opcional. |
Nenhum |
URL_FILTERING_ENABLED | Especifica se o recurso Redirecionamento de Conteúdo de URL está instalado. Um valor de 1 instala o recurso. Você deve usar as configurações de política de grupo para configurar quais URLs redirecionar. Consulte "Configurando o redirecionamento de conteúdo de URL" no documento Recursos e GPOs da Área de Trabalho Remota Horizon. Essa propriedade MSI é opcional. |
0 |
VDM_SKIP_BROKER_REGISTRATION | Um valor de 1 ignora áreas de trabalho não gerenciadas. | Nenhum |
VDM_VC_MANAGED_AGENT | Determina se vCenter Server gerencia a máquina virtual na qual Horizon Agent está instalado. Um valor de 1 configura a área de trabalho como uma máquina virtual gerenciada por vCenter Server. Um valor de 0 configura a área de trabalho como não gerenciada por vCenter Server. Essa propriedade MSI é obrigatória.
Observação: A opção de reparo do instalador não é compatível com uma instalação não gerenciada. Reparar essa instalação resulta em uma instalação de um
Horizon Agent gerenciado.
|
Nenhum |
VDM_REINSTALL | Especifica uma lista de recursos já instalados, delimitados por vírgulas que devem ser reinstalados, aplicável somente no modo silencioso. | Nenhum |
VDM_REINSTALLMODE | Uma cadeia de caracteres que contém letras que especificam o tipo de reinstalação a ser executada, aplicável somente no modo silencioso. Consulte https://learn.microsoft.com/en-us/windows/win32/msi/reinstallmode para obter detalhes sobre quais opções usar. | Nenhum |
VDM_SERVER_NAME | Nome do host ou endereço IP da instância do Servidor de Conexão na qual o instalador do Horizon Agent registra uma área de trabalho não gerenciada. Essa propriedade se aplica somente a áreas de trabalho não gerenciadas. Por exemplo: VDM_SERVER_NAME=10.123.01.01 Essa propriedade MSI é necessária para áreas de trabalho não gerenciadas. Não use essa propriedade MSI para áreas de trabalho virtuais gerenciadas por vCenter Server. |
Nenhum |
VDM_SERVER_USERNAME | Nome de usuário do administrador na instância do Servidor de Conexão. Essa propriedade do MSI se aplica somente a áreas de trabalho não gerenciadas. Por exemplo: VDM_SERVER_USERNAME=domínio\nome de usuário Essa propriedade MSI é necessária para áreas de trabalho não gerenciadas. Não use essa propriedade MSI para áreas de trabalho virtuais gerenciadas por vCenter Server. |
Nenhum |
VDM_SERVER_PASSWORD | Senha do usuário administrador do Servidor de Conexão. Por exemplo: VDM_SERVER_PASSWORD=secret Essa propriedade MSI é necessária para áreas de trabalho não gerenciadas. Não use essa propriedade MSI para áreas de trabalho virtuais gerenciadas por vCenter Server. |
Nenhum |
VDM_IP_PROTOCOL_USAGE | Especifica a versão do IP que Horizon Agent usa. Os valores válidos são IPv4 e IPv6. | IPv4 |
VDM_FIPS_ENABLED | Especifica se o modo FIPS deve ser ativado ou desativado. Um valor de 1 ativa o modo FIPS. Um valor de 0 desativa o modo FIPS. Se essa propriedade for definida como 1 e Windows não estiver no modo FIPS, o instalador será interrompido. | 0 |
VDM_FORCE_DESKTOP_AGENT | Se você instalar o Horizon Agent em uma máquina do Windows Server e configurá-la como uma área de trabalho do Horizon de usuário único em vez de um host RDS, defina o valor como 1. Esse requisito se aplica a máquinas gerenciadas por vCenter Server e a máquinas não gerenciadas. Para convidados Windows que não são do servidor que hospedam sessões de aplicativo, defina o valor como 0. Essa propriedade MSI é opcional. |
0 |
Em um comando de instalação silenciosa, você pode usar a propriedade ADDLOCAL para especificar as opções que o instalador do Horizon Agent configura.
A tabela a seguir mostra as opções Horizon Agent que você pode inserir na linha de comando. Essas opções têm opções de configuração correspondentes que você pode desmarcar ou selecionar durante uma instalação interativa.
Quando você não usa a propriedade ADDLOCAL na linha de comando, Horizon Agent instala todas as opções que são instaladas por padrão durante uma instalação interativa, se elas forem suportadas no sistema operacional guest. Quando você usa o ADDLOCAL=ALL, o Horizon Agent instala todas as opções a seguir, ativadas por padrão e desativadas por padrão, se elas forem compatíveis com o sistema operacional convidado.
Para obter mais informações, consulte a entrada da tabela ADDLOCAL em Opções de linha de comando do Microsoft Windows Installer.
Se você usar ADDLOCAL para especificar recursos individualmente (não especifique ADDLOCAL=ALL), sempre especifique Core.
Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* | Select-Object DisplayName, ModifyPath | Where-Object {$_.DisplayName -eq 'VMware Horizon Agent'} | Format-Table –AutoSizeA saída:
DisplayName ModifyPath VMware Horizon Agent MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}
O exemplo a seguir modifica e remove o componente USB de uma instalação existente: VMware -Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn REMOVE=USB"
O exemplo a seguir modifica a instalação do agente substituindo Horizon Performance Tracker por Horizon Help Desk Tool: VMware -Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=HelpDesk REMOVE= PerfTracker”
O exemplo a seguir modifica a instalação do agente adicionando a porta serial e o redirecionamento do scanner: VMware -Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection” }
Opção de instalação silenciosa | Opção de configuração personalizada em uma instalação interativa | Instalado por padrão interativamente ou quando ADDLOCAL não é usado |
---|---|---|
Núcleo | As funções principais do Horizon Agent. Se você especificar ADDLOCAL=ALL, os recursos do Core serão instalados. |
Sim |
PCoIP | Agente de protocolo PCoIP | Sim |
USB | Redirecionamento USB | Não |
NGVC | Agente de clone instantâneo | Não |
RTAV | Áudio e vídeo em tempo real | Sim |
ClientDriveRedirection | Redirecionamento de unidade de cliente | Sim |
SerialPortRedirection | Redirecionamento de porta serial | Não |
Redirecionamento de Scanner | Redirecionamento do scanner | Não |
GEOREDIR | Redirecionamento de geolocalização | Não |
V4V | Horizon Monitoring Service Agent | Sim |
SmartCard | Cartão inteligente Esse recurso não é instalado por padrão em uma instalação interativa. |
Não |
VmwVaudioGenericName | VMware Áudio (driver de áudio virtual) | Sim |
VmwViddGenericName | VMware Driver de vídeo indireto | Sim
Observação: O VmwVidd será instalado e marcado como Local no registro somente se:
O VmwVidd é instalado e definido como Absent no registro no Windows Server 2019 (versão 1809) std e no datacenter com a função RDS. O VmwVidd será instalado e definido como Local no registro em Windows Server 2022 com a função RDS. |
TSMMR | Windows Media Redirecionamento de multimídia (MMR) | Sim |
RDP | Habilita o RDP no registro se você usar a propriedade RDP_CHOICE=1 na linha de comando ou selecionar RDP como o protocolo de exibição padrão ao criar ou editar um pool de áreas de trabalho. Esse recurso fica oculto durante instalações interativas. |
Sim |
RDSH3D | Renderização 3D em hosts RDS | Não |
BlastUDP | Suporte de transporte UDP para Blast | Sim |
SdoSensor | Redirecionamento do Sensor SDO | Não |
PerfTracker | Horizon Performance Tracker | Não |
HelpDesk | Horizon Help Desk Tool | Sim |
PrintRedir | VMware Integrated Printing | Sim |
PSG | Esse recurso define uma entrada do Registro que informa ao Servidor de Conexão se o Horizon Agent está usando IPv4 ou IPv6. | Sim |