--- title: "Implementação do agente macOS via Intune" slug: "deploy-macos-agent-via-intune" updated: 2026-06-15T22:01:57Z published: 2026-06-15T22:01:57Z canonical: "learn.workforceexperience.hp.com/deploy-macos-agent-via-intune" --- > ## Documentation Index > Fetch the complete documentation index at: https://learn.workforceexperience.hp.com/llms.txt > Use this file to discover all available pages before exploring further. # Implementação do agente macOS via Intune ### **Introdução** O agente HP Insights macOS ajuda a registar e ligar dispositivos macOS à HP Workforce Experience Platform (WXP). Este artigo descreve como implementar o `HPInsightsInstaller.pkg` em dispositivos macOS geridos utilizando o Microsoft Intune. Também explica como adicionar a configuração de registo, configurar regras de deteção e atribuir a aplicação aos grupos de dispositivos ou utilizadores necessários. ### **Pré-requisitos** Antes da implementação, certifique-se de que os seguintes requisitos são cumpridos: - Os dispositivos macOS estão registados com sucesso no Microsoft Intune. - O Apple MDM Push Certificate está configurado e ativo. - Uma licença do Intune está atribuída aos utilizadores-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 registo for necessária). - O grupo de dispositivos ou utilizadores do Microsoft Entra ID (Azure AD) necessário está criado para a atribuição. ### **Visão geral do processo de implementação** 1. Carregamento do `HPInsightsInstaller.pkg` no Intune 2. Configuração dos metadados da aplicação 3. Configuração de um script de pré-instalação de registo 4. Configuração de regras de deteção 5. Definição de requisitos 6. Atribuição da aplicação a grupos de dispositivos ou utilizadores | Conceito | Finalidade | | --- | --- | | Implementação PKG | Instala o agente HP Insights macOS | | Script de pré-instalação | Cria o `enrollment.json` e a configuração necessária antes do início da instalação do agente. | | `enrollment.json` | Fornece o PIN da empresa ou as informações de registo necessárias para o registo do dispositivo | ### **Passo 1: Carregamento do HPInsightsInstaller.pkg no Intune** 1. Inicie sessão no [Intune Admin Center](https://intune.microsoft.com/). 2. Clique em **Aplicações** > **macOS** > **Adicionar**. 3. Selecione a aplicação macOS (PKG). 4. Clique em **Selecionar**. 5. Carregue o ficheiro `HPInsightsInstaller.pkg`. 6. Clique em **OK**. O `HPInsightsInstaller.pkg` instala o agente HP Insights macOS em dispositivos macOS geridos. O agente liga o dispositivo ao WXP após a instalação e o registo. ### **Passo 2: Configuração das informações da aplicação** Adicione os seguintes detalhes e clique em **Seguinte**: - **Nome**: HP Insights macOS Agent - **Descrição**: Forneça uma descrição apropriada. - **Editor**: HP - **Categoria**: Aplicações - **Logótipo**: Opcional. ### **Passo 3: Configuração do script de pré-instalação** Utilize o script de pré-instalação apenas se a sua implementação exigir que o ficheiro `enrollment.json` seja criado no dispositivo antes da instalação do agente HP Insights. Se o seu pacote já incluir a configuração de registo necessária, ou se outro método de implementação criar o ficheiro, este passo pode não ser necessário. Este passo é obrigatório para o registo silencioso. **Script 1** ```plaintext #!/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** ```plaintext 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 de ser ocultado dos utilizadores finais. Omita este valor se o ícone precisar de 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. ### **Passo 4: Definição de requisitos** Defina o seguinte e clique em **Seguinte**: - **Versão mínima do macOS**: Por exemplo, macOS 12 ou posterior. - **Arquitetura**: Predefinida. ### **Passo 5: Configuração de regras de deteção (passo crítico)** Configure a regra de deteção com base no pacote da aplicação do agente HP Insights instalado. Se a regra de deteção não corresponder à aplicação instalada, o Intune poderá reportar a implementação como falhada, mesmo quando o pacote for instalado corretamente. Se a aplicação for instalada no diretório /Applications, configure o seguinte: - **ID do pacote da aplicação**: com.hp.DaasClient.macOS.APMAgent - **(Opcional) Comparação de versões** Certifique-se de que a regra de deteção corresponde ao comportamento real de instalação do pacote. ### **Passo 6: Configuração de atribuições** Selecione o seguinte tipo de atribuição: - **Obrigatório**: É instalado automática e silenciosamente. - **Disponível**: Os utilizadores instalam a aplicação pelo Company Portal. Para a implementação silenciosa automática: 1. Selecione **Obrigatório** e atribua a aplicação ao grupo de dispositivos apropriado. 2. Clique em **Seguinte**. 3. Clique em **Criar**. ## **Contacte-nos** Para qualquer assistência, crie um [**caso de suporte**](/wxp/docs/pt/creating-a-support-case) ou envie um e-mail para [**support@wxp.hp.com**](mailto:support@wxp.hp.com).