Implantação do agente macOS via Intune

Introdução

O agente HP Insights macOS ajuda a registrar e conectar dispositivos macOS à HP Workforce Experience Platform (WXP). Este artigo descreve como implantar o HPInsightsInstaller.pkg em dispositivos macOS gerenciados usando o Microsoft Intune. Também explica como adicionar a configuração de registro, configurar regras de detecção e atribuir o aplicativo aos grupos de dispositivos ou usuários necessários.

Pré-requisitos

Antes da implantação, certifique-se de que os seguintes requisitos sejam atendidos:

• Os dispositivos macOS estão registrados com sucesso no Microsoft Intune.

• O Apple MDM Push Certificate está configurado e ativo.

• Uma licença do Intune está atribuída aos usuários-alvo.

• O HPInsightsInstaller.pkg está finalizado e testado para instalação silenciosa.

• O PIN da empresa está disponível (se a configuração JSON de registro for necessária).

• O grupo de dispositivos ou usuários do Microsoft Entra ID (Azure AD) necessário está criado para a atribuição.

Visão geral do processo de implantação

1. Upload do HPInsightsInstaller.pkg no Intune

2. Configuração dos metadados do aplicativo

3. Configuração de um script de pré-instalação de registro

4. Configuração de regras de detecção

5. Definição de requisitos

6. Atribuição do aplicativo a grupos de dispositivos ou usuários

Etapa 1: Upload do HPInsightsInstaller.pkg no Intune

1. Faça login no Intune Admin Center.

2. Clique em Aplicativos > macOS > Adicionar.

3. Selecione o aplicativo macOS (PKG).

4. Clique em Selecionar.

5. Faça o upload do arquivo HPInsightsInstaller.pkg.

6. Clique em OK.

O HPInsightsInstaller.pkg instala o agente HP Insights macOS em dispositivos macOS gerenciados. O agente conecta o dispositivo ao WXP após a instalação e o registro.

Etapa 2: Configuração das informações do aplicativo

Adicione os seguintes detalhes e clique em Próximo:

• Nome: HP Insights macOS Agent

• Descrição: Forneça uma descrição apropriada.

• Editor: HP

• Categoria: Aplicativos

• Logotipo: Opcional.

Etapa 3: Configuração do script de pré-instalação

Use o script de pré-instalação somente se a sua implantação exigir que o arquivo enrollment.json seja criado no dispositivo antes da instalação do agente HP Insights. Se o seu pacote já incluir a configuração de registro necessária, ou se outro método de implantação criar o arquivo, esta etapa pode não ser necessária.

Esta etapa é obrigatória para o registro silencioso.

Script 1

#!/bin/bash

APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
PIN=#########

if [ ! -d "$APPLICATION_SUPPORT_DIRECTORY" ]; then
    mkdir -p "$APPLICATION_SUPPORT_DIRECTORY"
fi

echo "{\"PIN\":\"$PIN\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
if [ -f "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json" ]; then
    exit 0
else
    exit 1
fi

Script 2

Enrollment_Tray.sh (Opção de ocultar ícone da barra de menus)
#!/bin/bash

APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
PIN=#########

if [ ! -d "$APPLICATION_SUPPORT_DIRECTORY" ]; then
    mkdir -p "$APPLICATION_SUPPORT_DIRECTORY"
fi

echo "{\"PIN\":\"$PIN\",\"HideTray\":\"true\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"

if [ -f "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json" ]; then
    exit 0
else
    exit 1
fi

Nota: O valor HideTray controla se o ícone do agente HP Insights é visível na barra de menus do macOS. Defina HideTray como true se o ícone da barra de menus precisar ser ocultado dos usuários finais. Omita este valor se o ícone precisar permanecer visível.

Selecione o script apropriado com base na visibilidade do ícone do menu; em seguida, cole-o em Script de pré-instalação.

Etapa 4: Definição de requisitos

Defina o seguinte e clique em Próximo:

• Versão mínima do macOS: Por exemplo, macOS 12 ou posterior.

• Arquitetura: Padrão.

Etapa 5: Configuração de regras de detecção (etapa crítica)

Configure a regra de detecção com base no pacote do aplicativo do agente HP Insights instalado. Se a regra de detecção não corresponder ao aplicativo instalado, o Intune poderá relatar a implantação como falha, mesmo quando o pacote for instalado corretamente.

Se o aplicativo for instalado no diretório /Applications, configure o seguinte:

• ID do pacote do aplicativo: com.hp.DaasClient.macOS.APMAgent

• (Opcional) Comparação de versões

Certifique-se de que a regra de detecção corresponda ao comportamento real de instalação do pacote.

Etapa 6: Configuração de atribuições

Selecione o seguinte tipo de atribuição:

• Obrigatório: É instalado automática e silenciosamente.

• Disponível: Os usuários instalam o aplicativo pelo Company Portal.

Para a implantação silenciosa automática:

1. Selecione Obrigatório e atribua o aplicativo ao grupo de dispositivos apropriado.

2. Clique em Próximo.

3. Clique em Criar.