Aggiungere un'app PKG macOS non gestita a Microsoft Intune

Usare le informazioni contenute in questo articolo per aggiungere un'app PKG macOS non gestita a Microsoft Intune. Per distribuire un'app PKG gestita, vedere Come aggiungere app line-of-business (LOB) macOS a Microsoft Intune.

Prerequisiti

Prima di installare un'app PKG macOS non gestita nei dispositivi macOS, è necessario soddisfare i prerequisiti seguenti.

  • I dispositivi sono gestiti da Intune.
  • Le dimensioni del file PKG sono inferiori a 8 GB.
  • Viene installato l'agente di gestione Microsoft Intune per macOS versione 2308.006 o successiva.
  • Il file PKG viene eseguito correttamente usando il installer comando in Terminale.

Considerazioni importanti per la distribuzione di app PKG

Il tipo di app PKG macOS non gestito può installare i tipi di app PKG seguenti:

  • Pacchetti non gonfiati con una struttura gerarchica
  • Pacchetti di componenti
  • Pacchetti non firmati
  • Pacchetti senza payload
  • Pacchetti che installano app all'esterno /Applications/
  • Pacchetti personalizzati con script

Nota

È possibile che questi tipi di app PKG non vengano distribuiti correttamente usando il tipo di app LOB gestito.

I file dell'app contenitore possono essere elencati nella sezione App incluse nella scheda Regole di rilevamento in ordine, a partire dall'app padre da usare nei report.

Selezionare il tipo di app

  1. Accedere all'interfaccia di amministrazione Microsoft Intune.
  2. Selezionare App>Tutte le app>Aggiungi.
  3. Nel riquadro Seleziona tipo di app selezionare app macOS (PKG) in Altri tipi di app.
  4. Fare clic su Seleziona. Vengono visualizzati i passaggi Aggiungi app .

Passaggio 1: Informazioni sull'app

Selezionare il file del pacchetto dell'app:

  1. Nel riquadro Aggiungi app fare clic su Seleziona file del pacchetto dell'app.
  2. Nel riquadro File pacchetto app selezionare il pulsante Sfoglia. Selezionare quindi un file PKG macOS con l'estensione .pkg. Verranno visualizzati i dettagli dell'app.
  3. Al termine, selezionare OK nel riquadro file del pacchetto dell'app per aggiungere l'app.

Impostare le informazioni sull'app

  1. Nella pagina Informazioni sull'app aggiungere i dettagli per l'app. A seconda dell'app scelta, alcuni dei valori in questo riquadro potrebbero essere compilati automaticamente.

    • Nome: immettere il nome dell'app come visualizzato nel nome dei criteri e nel portale aziendale. Assicurarsi che tutti i nomi di app usati siano univoci. Se lo stesso nome dell'app esiste due volte, nel portale aziendale viene visualizzata solo una delle app.
    • Descrizione: immettere la descrizione dell'app. La descrizione viene visualizzata nel portale aziendale.
    • Autore: immettere il nome dell'editore dell'app.
    • Categoria: selezionare una o più categorie di app predefinite oppure selezionare una categoria creata. Le categorie semplificano la ricerca dell'app da parte degli utenti durante l'esplorazione nel portale aziendale.
    • URL informazioni: facoltativamente, immettere l'URL di un sito Web che contiene informazioni sull'app. L'URL viene visualizzato nel portale aziendale.
    • URL privacy: facoltativamente, immettere l'URL di un sito Web che contiene informazioni sulla privacy per questa app. L'URL viene visualizzato nel portale aziendale.
    • Sviluppatore: facoltativamente, immettere il nome dello sviluppatore dell'app.
    • Proprietario: facoltativamente, immettere un nome per il proprietario dell'app. Un esempio è il reparto risorse umane.
    • Note: immettere le note da associare all'app.
    • Logo: caricare un'icona associata all'app. Questa icona viene visualizzata con l'app quando gli utenti sfogliano il portale aziendale.
  2. Fare clic su Avanti per impostare i requisiti.

Passaggio 2 - Programma

Facoltativamente, è possibile configurare uno script di preinstallazione e uno script post-installazione per personalizzare l'installazione dell'app.

Script di pre-installazione: specificare uno script eseguito prima dell'installazione dell'app. Solo quando lo script di preinstallazione restituisce zero (che indica l'esito positivo), l'app procede all'installazione. Se lo script di preinstallazione restituisce un codice diverso da zero (che indica un errore), l'app non esegue l'installazione e segnala lo stato di installazione come "non riuscito". Lo script di preinstallazione viene eseguito di nuovo per le installazioni non riuscite al successivo check-in del dispositivo (sincronizzazione).

Script post-installazione: specificare uno script eseguito dopo l'installazione dell'app. Se specificato, lo script dopo l'installazione viene eseguito dopo un'installazione corretta dell'app. Indipendentemente dallo stato di esecuzione dello script post-installazione, un'app installata segnala lo stato di installazione come "operazione riuscita".

Nota

  • Ogni script preinstalla o post-installazione deve avere una lunghezza inferiore a 5121 caratteri.
  • L'agente di gestione Microsoft Intune per macOS versione 2309.007 o successiva è necessario per configurare script preinstallati e post-installazione per le app PKG macOS.
  • Per altre informazioni sulla configurazione degli script di preinstallazioni e post-installazione, vedere Prerequisiti degli script della shell.

Passaggio 3 - Requisiti

È possibile scegliere il sistema operativo minimo necessario per installare questa app.

Sistema operativo minimo: nell'elenco scegliere la versione minima del sistema operativo in cui è possibile installare l'app. Se si assegna l'app a un dispositivo con un sistema operativo precedente, non verrà installata.

Passaggio 4: Regole di rilevamento

È possibile usare le regole di rilevamento per scegliere come viene rilevata un'installazione dell'app in un dispositivo macOS gestito.

Ignora la versione dell'app: selezionare per installare l'app se l'app non è già installata nel dispositivo. Questa operazione cercherà solo la presenza dell'ID bundle dell'app. Per le app con un meccanismo di aggiornamento automatico, selezionare . Selezionare No per installare l'app quando non è già installata nel dispositivo o se il numero di versione dell'app di distribuzione non corrisponde alla versione già installata nel dispositivo.

App incluse: specificare le app contenute nel file caricato. Gli ID bundle dell'app inclusi e i numeri di build vengono usati per rilevare e monitorare lo stato di installazione dell'app del file caricato. L'elenco delle app incluse deve contenere solo le applicazioni installate dal file caricato. Qualsiasi altro tipo di file che non è un'applicazione deve essere escluso dall'elenco App incluse . Se l'elenco Delle app incluse contiene file che non sono applicazioni o se tutte le app elencate non sono installate, lo stato di installazione dell'app non segnala l'esito positivo.

Nota

  • La prima app nell'elenco App incluse viene usata per identificare l'app quando sono presenti più app nel file PKG.
  • e CFBundleIdentifierCFBundleShortVersionString sono disponibili nel <app_name>.app/Contents/Info.plist file di un'app installata in un Mac.
    In alternativa, terminale Mac può essere usato per cercare e confermare i dettagli dell'app inclusa di un'app installata in una posizione nota.
    Ad esempio, per cercare l'ID bundle e il numero di build di Portale aziendale, eseguire quanto segue:
    defaults read /Applications/Company\ Portal.app/Contents/Info CFBundleIdentifier
    Eseguire quindi quanto segue:
    defaults read /Applications/Company\ Portal.app/Contents/Info CFBundleShortVersionString

Passaggio 5: Selezionare i tag di ambito (facoltativo)

È possibile usare i tag di ambito per determinare chi può visualizzare le informazioni sull'app client in Intune. Per informazioni dettagliate sui tag di ambito, vedere Usare il controllo degli accessi in base al ruolo e i tag di ambito per l'IT distribuito. 1. Fare clic su Seleziona tag di ambito per aggiungere facoltativamente tag di ambito per l'app. 2. Fare clic su Avanti per visualizzare la pagina Assegnazioni .

Passaggio 6 - Assegnazioni

È possibile selezionare l'assegnazione gruppo Obbligatorio per l'app. Per altre informazioni, vedere Aggiungere gruppi per organizzare utenti e dispositivi eAssegnare app a gruppi con Microsoft Intune.

Nota

Un'app macOS distribuita con l'agente di Intune non verrà rimossa automaticamente dal dispositivo quando il dispositivo viene ritirato. L'app e i dati in esso contenuti rimarranno nel dispositivo. È consigliabile rimuovere l'app prima del ritiro del dispositivo.

  1. Per l'app specifica, selezionare Tipo di assegnazione obbligatorio .
  2. Fare clic su Avanti per visualizzare la pagina Rivedi e crea.

Passaggio 7: Rivedere e creare

  1. Esaminare i valori e le impostazioni immessi per l'app.
  2. Al termine, fare clic su Crea per aggiungere l'app a Intune. Viene visualizzato il riquadro Panoramica per l'app PKG macOS.

L'app creata viene visualizzata nell'elenco delle app in cui è possibile assegnarla ai gruppi scelti. Per informazioni, vedere Come assegnare app ai gruppi.

Problemi noti

  • "Disponibile per i dispositivi registrati" e il tipo di assegnazione "disinstallazione" non sono disponibili: è attualmente supportato solo il tipo di assegnazione obbligatorio .

Risoluzione dei problemi

L'installazione dell'app macOS potrebbe non riuscire a causa di uno dei motivi seguenti indicati nella tabella seguente. Per risolvere questi errori, seguire la procedura di correzione. Se l'app rimane assegnata, le installazioni non riuscite vengono ritentata al successivo check-in dell'agente.

Codice errore Messaggio di errore Passaggi di correzione
0x87D30137 Il dispositivo non soddisfa il requisito minimo del sistema operativo impostato dall'amministratore. Aggiornare macOS alla versione minima del sistema operativo richiesta dall'amministratore.
2016214710 Lo script di preinstallazione fornito dall'amministratore non è riuscito. Questo potrebbe essere previsto se lo script di preinstallazione è in attesa che una condizione diventi vera prima che l'installazione dell'app possa continuare. Lo script di preinstallazione non riuscito verrà ritento al successivo check-in del dispositivo. Controllare lo script di preinstallazione se l'errore persiste.
0x87D3012F, 0x87D30130, 0x87D30133, 0x87D30134, 0x87D30136, Impossibile installare l'app a causa di un errore interno. Se l'errore persiste, contattare il supporto di Intune. Si è verificato un problema durante l'installazione dell'app con Intune. Provare a installare manualmente l'app o a creare un nuovo profilo dell'app macOS contenente l'app. Se l'errore persiste, contattare il supporto di Intune.

Si noti che l'errore di script post-installazione non viene segnalato. Un'installazione corretta dell'app seguita da uno script post-installazione non riuscito segnalerà lo stato di installazione dell'app come "operazione riuscita".

Passaggi successivi