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 vengono 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
- Accedere all'Interfaccia di amministrazione di Microsoft Intune.
- Selezionare App>create da tutte le app>.
- Nel riquadro Seleziona tipo di app selezionare app macOS (PKG) in Altri tipi di app.
- Fare clic su Seleziona. Vengono visualizzati i passaggi Aggiungi app .
Passaggio 1: Informazioni sull'app
Selezionare il file del pacchetto dell'app:
- Nel riquadro Aggiungi app fare clic su Seleziona file del pacchetto dell'app.
- 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.
- Al termine, selezionare OK nel riquadro file del pacchetto dell'app per aggiungere l'app.
Impostare le informazioni sull'app
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.
Selezionare 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 viene installata e segnala il relativo 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 15360 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 Sì 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 Sì. 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
- Se un pacchetto PKG contiene più app, solo una di queste può essere visualizzata nei report delle app correlate.
- Il primo ID app/bundle nell'elenco App incluse è quello su cui verrà segnalato. L'elenco può essere riordinato, se necessario.
- Nel caso dell'app Portale aziendale Intune, nel PKG sono incluse molte librerie aggiuntive che possono essere rimosse in modo sicuro (usando l'icona del cestino). Verrà lasciato un solo ID bundle dell'app:
com.microsoft.CompanyPortalMac
Consiglio
E CFBundleIdentifier
CFBundleShortVersionString
può essere trovato 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
Per le app aggiunte a Intune, è possibile usare l'interfaccia di amministrazione Intune per ottenere l'ID bundle dell'app.
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. Selezionare Avanti per visualizzare la pagina Assegnazioni .
Passaggio 6 - Assegnazioni
È possibile selezionare le assegnazioni di gruppo Obbligatorio o Disponibile 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 usando Intune'agente 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.
- Per l'app specifica, selezionare il tipo di assegnazione Obbligatorio o Disponibile .
- Selezionare Avanti per visualizzare la pagina Rivedi e crea .
Passaggio 7: Rivedere e creare
- Esaminare i valori e le impostazioni immessi per l'app.
- Al termine, selezionare 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
- Il tipo di assegnazione Disinstalla non è disponibile. Sono attualmente supportate solo le assegnazioni Required e Available.
- Il Portale aziendale Intune mostra lo stato In sospeso anche dopo l'installazione corretta dell'app. In particolare, Le app disponibili vengono visualizzate come In sospeso dopo che l'utente ha fatto clic sul pulsante Installa nell'app Portale aziendale anche dopo che le app sono state installate correttamente. Gli utenti possono ritentare l'installazione facendo clic su Controlla stato nel dispositivo locale nella scheda Dispositivi dell'app Portale aziendale. La creazione di report nella console di Intune Amministrazione non è interessata da questo problema. Questo problema viene risolto attivamente.
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. Contattare Intune supporto se l'errore persiste. | Si è verificato un problema durante l'installazione dell'app usando Intune. Provare a installare manualmente l'app o a creare un nuovo profilo dell'app macOS contenente l'app. Contattare Intune supporto se l'errore persiste. |
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
- L'app creata viene visualizzata nell'elenco delle app. È ora possibile assegnarlo ai gruppi scelti. Per informazioni, vedere Come assegnare app ai gruppi.
- Altre informazioni sui modi in cui è possibile monitorare le proprietà e l'assegnazione dell'app. Per altre informazioni, vedere Come monitorare le informazioni e le assegnazioni delle app.
- Altre informazioni sul contesto dell'app in Intune. Per altre informazioni, vedere Panoramica dei cicli di vita di dispositivi e app