IntuneBrew is a PowerShell-based tool that simplifies the process of uploading and managing macOS applications in Microsoft Intune. It automates the entire workflowβfrom downloading apps to uploading them to Intune with proper metadata and icons.
This project uses publicly available metadata from Homebrewβs JSON API. Homebrew is a registered trademark of its respective owners and is not affiliated with or endorsing this project.
- Watch the full walkthrough of the tool:
- Table of Contents
- οΏ½ Latest Updates
- β¨ Features
- π Getting Started
- π Usage
- π§ Configuration
- π Version Management
- π οΈ Error Handling
- π€ Troubleshooting
- π€ Contributing
- π License
- π Acknowledgments
- π Support
Last checked: 2025-05-22 00:30 UTC
| Application | Previous Version | New Version |
|---|---|---|
| ProcessSpy | 1.7.0 | 1.7.1 |
| NVIDIA GeForce NOW | 2.0.73.149 | 2.0.74.160 |
| DockDoor | 1.10 | 1.11 |
| Yaak | 2025.2.0 | 2025.2.2 |
| 6.9.72 | 6.9.73 | |
| iMazing | 3.2.0 | 3.2.1 |
| Raycast | 1.98.5 | 1.99.0 |
| Zed | 0.186.12 | 0.187.4 |
| Amazon Chime | 5.23.22318 | 5.23.22356 |
| Malwarebytes for Mac | 5.14.1.3074 | 5.14.2.3077 |
- π Automated app uploads to Microsoft Intune
- π¦ Supports both .dmg and .pkg files
- π Automatic version checking and updates
- πΌοΈ Automatic app icon integration
- π Progress tracking for large file uploads
- π Secure authentication with Microsoft Graph API
- π― Smart duplicate detection
- π« Bulk upload support
- π Automatic retry mechanism for failed uploads
- π Secure file encryption for uploads
- π Real-time progress monitoring
- PowerShell 7.0 or higher
- Administrator rights (script must be installed as administrator, specially if you use "Install-Script IntuneBrew -Force")
- Microsoft.Graph.Authentication Module must be installed
- Azure App Registration with appropriate permissions OR Manual Connection via Interactive Sign-In
- Windows or macOS operating system
Download the script: IntuneBrew.ps1
Run the script:
.\IntuneBrew.ps1Follow the interactive prompts to:
- Select which apps to upload
- Authenticate with Microsoft Graph
- Monitor the upload progress
- View the results in Intune
| Application | Latest Version |
|---|---|
 1Password |
8.10.76 |
 A Better Finder Rename |
12.12 |
 Abstract |
98.6.1 |
 Acorn |
8.1.1 |
 Acronis True Image |
29.2 |
 AdGuard |
2.16.4.1870 |
 Adobe Acrobat Pro DC |
25.001.20476 |
 Adobe Acrobat Reader |
25.001.20467 |
 Adobe Creative Cloud |
6.6.0.611 |
 Advanced Renamer |
4.11 |
 AirBuddy |
2.7.3 |
 Aircall |
3.1.66 |
 Airfoil |
5.12.4 |
 AirParrot |
3.1.7 |
 Airtable |
1.6.6 |
 Airy |
3.29.2 |
 Alacritty |
0.15.1 |
 Alcove |
1.2.5 |
 Alfred |
5.6.2 |
 AltTab |
7.24.0 |
 Amadine |
1.6.7 |
 Amazon Chime |
5.23.22356 |
 Amazon Q |
1.10.1 |
 Android Studio |
2024.3.2.14 |
 Angry IP Scanner |
3.9.1 |
 Anki |
25.02.5 |
 Antinote |
1.1.5 |
 Any.do |
5.0.68 |
 AnyDesk |
9.0.2 |
 Apidog |
2.7.12 |
 Apifox |
2.7.12 |
 Apparency |
2.2 |
 Arc |
1.95.1 |
 Archaeology |
1.2 |
 Arduino IDE |
2.3.6 |
 Asana |
2.4.0 |
 Asset Catalog Tinkerer |
2.9 |
 Atlassian SourceTree |
4.2.12 |
 Audacity |
3.7.3 |
 Audio Hijack |
4.5.1 |
 Autodesk Fusion 360 |
latest |
 AWS Client VPN |
5.2.0 |
 AWS Corretto JDK |
21.0.7.6.1 |
 Azul Zulu Java Standard Edition Development Kit |
24.0.1 |
 Azure Data Studio |
1.51.1 |
 Background Music |
0.4.3 |
 Badgeify |
1.6.6 |
 Bambu Studio |
02.00.03.54 |
 Bartender |
5.3.6 |
 Basecamp |
3 |
 BatFi |
2.4.2 |
 BBEdit |
15.1.4 |
 Beeper |
4.0.710 |
 BetterDisplay |
3.5.5 |
 BetterMouse |
1.6 |
 BetterTouchTool |
5.414 |
 BetterZip |
5.3.4 |
 Beyond Compare |
5.0.7.30840 |
 Binary Ninja |
5.0.7290 |
 Bitwarden |
2025.4.2 |
 Bitwig Studio |
5.3.8 |
 Blender |
4.4.3 |
 BLEUnlock |
1.12.2 |
 blip |
1.1.7 |
 Blizzard Battle.net |
1.18.10.3141 |
 BlurScreen |
1.0 |
 BoltAI |
1.35.2 |
 Bome Network |
1.6.0 |
 Boop |
1.4.0 |
 Boxcryptor |
3.13.680 |
 Brave |
1.78.102.0 |
 BreakTimer |
1.3.2 |
 Bruno |
2.3.0 |
 BusyCal |
2025.2.1 |
 BusyContacts |
2025.2.1 |
 Caffeine |
1.5.1 |
 calibre |
8.4.0 |
 Calmly Writer |
2.0.59 |
 Camtasia |
25.1.0 |
 Canva |
1.108.0 |
 CapCut |
3.3.0.1159 |
 ChatGPT |
1.2025.133 |
 ChatWise |
0.8.53 |
 Chrome Remote Desktop |
136.0.7103.19 |
 Cisco Jabber |
20250430033337 |
 Citrix Workspace |
25.03.10.24 |
 Claude |
0.9.3 |
 CleanMyMac |
5.0.9 |
 CleanShot |
4.7.6 |
 CLion |
2025.1.1 |
 Clipy |
1.2.1 |
 Clop |
2.9.3 |
 Cloudflare WARP |
2025.4.929.0 |
 CodeEdit |
0.3.4 |
 CodeRunner |
4.4.1 |
 Company Portal |
5.2504.0 |
 Copilot for Xcode |
0.35.8 |
 CopyClip |
2.9.99.2 |
 CotEditor |
5.1.6 |
 Cryptomator |
1.16.2 |
 Crystalfetch |
2.2.0 |
 Cursor |
0.50.5 |
 Cyberduck |
9.1.4 |
 DaisyDisk |
4.31 |
 Dangerzone |
0.9.0 |
 Dataflare |
2.0.0 |
 DataGrip |
2025.1.2 |
 DataSpell |
2025.1.1 |
 DB Browser for SQLite |
3.13.1 |
 DBeaver Community Edition |
25.0.5 |
 DbGate |
6.4.2 |
 DeepL |
25.5.12046922 |
 DeskPad |
1.3.2 |
 DevToys |
2.0.8.0 |
 DevUtils |
1.17.0 |
 Discord |
0.0.346 |
 DisplayLink USB Graphics Software |
1.12.2 |
 DockDoor |
1.11 |
 Docker Desktop |
4.41.2 |
 Dockside |
1.9.54 |
 DOSBox |
0.74-3 |
 Doughnut |
2.0.1 |
 Downie |
4.9.16 |
 draw.io Desktop |
27.0.5 |
 DrawBot |
3.132 |
 DriveDX |
1.12.1 |
 Dropbox |
224.4.4811 |
 DropDMG |
3.6.8 |
 Dropshare |
6.3 |
 DuckDuckGo |
1.139.0 |
 Easydict |
2.14.1 |
 EasyFind |
5.0.2 |
 Eclipse Temurin Java Development Kit |
24.0.1 |
 EdrawMax |
12.6.1 |
 Elephas |
11.1087 |
 Elgato Camera Hub |
2.0.0.5750 |
 Elgato Capture Device Utility |
1.3.1 |
 Elgato Stream Deck |
6.9.0.21694 |
 Elgato Wave Link |
2.0.6.3780 |
 Ente |
1.7.12 |
 Ente Auth |
4.3.6 |
 Epic Games Launcher |
18.5.0 |
 Espanso |
2.2.1 |
 Etcher |
2.1.2 |
 Evernote |
10.105.4 |
 f.lux |
42.2 |
 Facebook Messenger |
233.1.0.8.208 |
 Fantastical |
4.0.12 |
 Fathom |
1.40.0 |
 Figma |
125.4.9 |
 Fission |
2.8.8 |
 Flameshot |
12.1.0 |
 FlowVision |
1.6.3 |
 Flycut |
1.9.6 |
 Forecast |
0.9.6 |
 Foxit PDF Editor |
13.1.7 |
 Free Ruler |
2.0.8 |
 FreeCAD |
1.0.1 |
 Freelens |
1.3.0 |
 FreeMacSoft AppCleaner |
3.6.8 |
 FreeTube |
0.23.5 |
 FSMonitor |
1.2 |
 Gather Town |
1.32.0 |
 Geany |
2.0 |
 Geekbench |
6.4.0 |
 Geekbench AI |
1.3.0 |
 Gemini |
2.9.11 |
 Gephi |
0.10.1 |
 Ghostty |
1.1.3 |
 gifox |
2.6.5+0 |
 GIMP |
3.0.4 |
 Git Credential Manager |
2.6.1 |
 GitFinder |
1.7.11 |
 GitHub Desktop |
3.4.20-d2e01c60 |
 GitKraken |
11.1.1 |
 Godot Engine |
4.4.1 |
 Godspeed |
1.8.98 |
 Goland |
2025.1.1 |
 Google Ads Editor |
2.9 |
 Google Chrome |
136.0.7103.114 |
 Google Drive |
108.0.1 |
 Goose |
1.0.24 |
 GPT fdisk |
1.0.10 |
 Grammarly Desktop |
1.119.0.0 |
 GrandPerspective |
3.5.3 |
 Hammerspoon |
1.0.0 |
 Hazel |
6.0.4 |
 HazeOver |
1.9.4 |
 Headlamp |
0.30.0 |
 HEY |
1.2.17 |
 Hidden Bar |
1.9 |
 Highlight |
1.2.31 |
 Home Assistant |
2025.5 |
 Homerow |
1.4.0 |
 HP Easy Admin |
2.15.0 |
 HuggingChat |
0.7.0 |
 Huly |
0.6.501 |
 Hyper |
3.4.1 |
 Hyperkey |
0.47 |
 Ice |
0.11.12 |
 IINA |
1.3.5 |
 iMazing |
3.2.1 |
 iMazing Profile Editor |
2.0.0 |
 Inkscape |
1.4.230579 |
 Insomnia |
11.1.0 |
 Insta360 Studio |
5.6.1 |
 IntelliJ IDEA Community Edition |
2025.1.1.1 |
 IsThereNet |
1.7.1 |
 iTerm2 |
3.5.14 |
 Itsycal |
0.15.6 |
 Jabra Direct |
6.22.11401 |
 Jamie |
4.2.5 |
 Jellyfin |
10.10.7 |
 JetBrains PhpStorm |
2025.1.1 |
 Jetbrains PyCharm Community Edition |
2025.1.1.1 |
 JetBrains Rider |
2025.1.2 |
 JetBrains Toolbox |
2.6.2 |
 Joplin |
3.3.12 |
 Jumpcut |
0.84 |
 Jumpshare |
3.3.18 |
 Kap |
3.6.0 |
 Karabiner Elements |
15.3.0 |
 KeePassXC |
2.7.10 |
 Keeper Password Manager |
17.2 |
 Keka |
1.5.0 |
 Keybase |
6.5.1 |
 KeyCastr |
0.10.3 |
 KeyClu |
0.30.1 |
 kitty |
0.42.1 |
 Klokki |
1.3.7 |
 Krisp |
3.1.6 |
 Krita |
5.2.9 |
 LangGraph Studio |
0.0.37 |
 Last Window Quits |
1.1.4 |
 Lens |
2025.5.81206 |
 LibreOffice |
25.2.3 |
 LibreWolf |
138.0.4 |
 Little Snitch |
6.2.3 |
 LM Studio |
0.3.15 |
 LocalSend |
1.17.0 |
 Logitech G HUB |
2025.4.719084 |
 Logitech Options+ |
1.90.714605 |
 LookAway |
1.12.3 |
 Loop |
1.2.0 |
 LuLu |
3.1.5 |
 Lunatask |
2.0.22 |
 LΓVE |
11.5 |
 Maccy |
2.3.0 |
 MacDown |
0.7.2 |
 macFUSE |
4.10.2 |
 MacPass |
0.8.1 |
 Macs Fan Control |
1.5.17 |
 MacTeX |
2025.0308 |
 MacWhisper |
12.9.1 |
 Maestral |
1.9.4 |
 MagicQuit |
1.4 |
 Malwarebytes for Mac |
5.14.2.3077 |
 MarkEdit |
1.23.0 |
 MarsEdit |
5.3.4 |
 Marta File Manager |
0.8.2 |
 Mattermost |
5.12.0 |
 Medis |
2.15.1 |
 MeetingBar |
4.10.0 |
 Meld for macOS |
3.22.3+105 |
 MenuBar Stats |
3.9 |
 Micro Snitch |
1.6.1 |
 Microsoft Auto Update |
4.79.25033028 |
 Microsoft Azure Storage Explorer |
1.38.0 |
 Microsoft Edge |
136.0.3240.76 |
 Microsoft Office |
16.97.25051114 |
 Microsoft Teams |
25107.1606.3643.3915 |
 Microsoft Visual Studio Code |
1.100.2 |
 Middle |
1.9 |
 MiddleClick |
3.1.0 |
 Mindmanager |
24.1.155 |
 Miro |
0.11.99 |
 Mist |
0.20.1 |
 mitmproxy |
12.0.1 |
 Mixxx |
2.5.1 |
 Mobirise |
6.0.5 |
 Mockoon |
9.2.0 |
 MongoDB Compass |
1.46.2 |
 MonitorControl |
4.3.3 |
 Moonlight |
6.1.0 |
 Mos |
3.5.0 |
 Motrix |
1.8.19 |
 Mountain Duck |
4.17.4 |
 Mounty for NTFS |
2.4 |
 mouseless |
0.3.1 |
 Mozilla Firefox |
138.0.4 |
 Mozilla Firefox Developer Edition |
139.0b10 |
 Mozilla Firefox ESR |
128.10.1 |
 Mozilla Thunderbird |
138.0.2 |
 Multi |
0.538.2 |
 MultiViewer for F1 |
1.43.2 |
 MURAL |
3.0.4 |
 MySQL Workbench |
8.0.42 |
 Name Mangler |
3.9.3 |
 NeoFinder |
8.9 |
 NetBeans IDE |
25 |
 Netiquette |
2.3.0 |
 NetNewsWire |
6.1.9 |
 Nextcloud |
3.16.4 |
 Nitro PDF Pro |
14.7 |
 NoMachine |
8.16.1 |
 NordLayer |
3.6.0 |
 NordLocker |
4.26.1 |
 NordPass |
6.1.9 |
 NordVPN |
8.38.1 |
 NoSQL Workbench |
3.13.6 |
 Nota Gyazo GIF |
9.10.0 |
 NotesOllama |
0.2.6 |
 Notion |
4.11.1 |
 Notion Calendar |
1.130.0 |
 noTunes |
3.5 |
 Noun Project |
2.3 |
 Novabench |
5.5.4 |
 Nucleo |
4.1.6 |
 Nudge |
2.0.12.81807 |
 NVIDIA GeForce NOW |
2.0.74.160 |
 OBS |
31.0.3 |
 Obsidian |
1.8.10 |
 Okta Advanced Server Access |
1.89.1 |
 Ollama |
0.7.0 |
 OmniFocus |
4.5.3 |
 OmniOutliner |
5.14.3 |
 Omnissa Horizon Client |
2503-8.15.0-14236092062 |
 OneDrive |
25.070.0413.0001 |
 OnyX |
4.7.8 |
 OpenMTP |
3.2.25 |
 OpenVPN Connect client |
3.7.1 |
 Opera |
119.0.5497.40 |
 Oracle VirtualBox |
7.1.8 |
 OrbStack |
1.10.3 |
 Orca Slicer |
2.3.0 |
 Orka CLI |
2.4.0 |
 Orka Desktop |
3.0.0 |
 Overflow |
3.2.1 |
 OverSight |
2.4.0 |
 Packages |
1.2.10 |
 Paintbrush |
2.6.0 |
 Paletro |
1.11.0 |
 Panic Nova |
12.4 |
 Parallels Client |
19.4.3 |
 Parallels Desktop |
20.3.0-55895 |
 Parsec |
150-99 |
 Pastebot |
2.4.6 |
 PDF Expert |
3.10.14 |
 PDF Pals |
1.9.0 |
 Pearcleaner |
4.4.3 |
 pgAdmin4 |
9.3 |
 Philips Hue Sync |
1.12.1.65 |
 Phoenix Slides |
1.5.9 |
 Pika |
1.0.2 |
 PiPHero |
1.2.0 |
 PixelSnap |
2.6.1 |
 Platypus |
5.4.1 |
 Plex |
1.109.0.329 |
 PlistEdit Pro |
1.9.7 |
 Podman Desktop |
1.18.1 |
 PopChar X |
10.4 |
 portx |
2.2.12 |
 Postico |
2.1.2 |
 Postman |
11.46.2 |
 PowerShell |
7.5.1 |
 Principle |
6.38 |
 Privileges |
2.3.0 |
 ProcessSpy |
1.7.1 |
 ProNotes |
0.7.7 |
 Proton Drive |
2.4.0 |
 Proton Mail |
1.8.0 |
 Proton Pass |
1.31.4 |
 ProtonVPN |
4.8.0 |
 Proxyman |
5.19.0 |
 PS Remote Play |
8.0.0 |
 Pulsar |
1.128.0 |
 qBittorrent |
5.0.5 |
 QLab |
5.4.10 |
 QQ |
6.9.73 |
 QSpace Pro |
5.3.4 |
 quarto |
1.7.31 |
 QuickLook Video |
2.21 |
 qView |
6.1 |
 Raindrop.io |
5.6.76 |
 Rancher Desktop |
1.18.2 |
 Raycast |
1.99.0 |
 Reactotron |
3.7.7 |
 Readest |
0.9.43 |
 Real VNC Viewer |
7.13.1 |
 Rectangle |
0.87 |
 Rectangle Pro |
3.53 |
 Recut |
2.1.7 |
 Redis Insight |
2.68.0 |
 Reflector |
4.1.2 |
 Remote Desktop Manager |
2025.1.16.3 |
 Remote Help |
1.0.2404171 |
 Reqable |
2.33.12 |
 Requestly |
25.5.20 |
 Retcon |
1.3.0 |
 Rhinoceros |
8.19.25132.01002 |
 Rive |
0.8.2945 |
 Rocket |
1.9.4 |
 Rocket Typist |
3.2.2 |
 Rocket.Chat |
4.4.1 |
 Rode Central |
2.0.96 |
 Rode Connect |
1.3.43 |
 Rotato |
147 |
 RStudio |
2025.05.0 |
 RsyncUI |
2.5.3 |
 RustDesk |
1.4.0 |
 SABnzbd |
4.5.1 |
 Santa |
2025.4 |
 ScreenFocus |
1.1.1 |
 Sequel Ace |
5.0.8 |
 Shottr |
1.8.1 |
 Signal |
7.55.0 |
 SilentKnight |
2.11 |
 Sketch |
101.9 |
 SketchUp |
2025.0.633.273 |
 Skim |
1.7.10 |
 Slack |
4.44.60 |
 Snagit |
2025.2.0 |
 Splashtop Business |
3.7.4.2 |
 Splice |
5.3.2 |
 Spline |
0.12.5 |
 Spotify |
1.2.63.394 |
 Sproutcube Shortcat |
0.12.0 |
 SQLPro for MSSQL |
2025.10 |
 SQLPro for MySQL |
2025.10 |
 SQLPro for Postgres |
2025.06 |
 SQLPro for SQLite |
2025.07 |
 SQLPro Studio |
2025.10 |
 Squirrel |
1.0.3 |
 Stats |
2.11.43 |
 Steam |
4.0 |
 SteerMouse |
5.7.4 |
 Stretchly |
1.17.2 |
 Studio 3T |
2025.9.0 |
 Sublime Merge |
2102 |
 Sublime Text |
4200 |
 Superlist |
1.31.0 |
 superwhisper |
1.45.14 |
 Suspicious Package |
4.5 |
 Swift Shift |
0.27.1 |
 Sync |
2.2.48 |
 Syncovery |
11.3.5 |
 Synology Drive |
3.5.2 |
 Tableau Desktop |
2025.1.1 |
 TabTab |
1.3.4 |
 Tailscale |
1.84.0 |
 Taskbar |
1.4.5 |
 TeaCode |
1.1.3 |
 TeamViewer Host |
15 |
 TeamViewer QuickSupport |
15 |
 Telegram for macOS |
11.11 |
 Tenable Nessus Agent |
10.8.4 |
 Termius |
9.20.0 |
 TeX Live Utility |
1.54 |
 TextMate |
2.0.23 |
 Thonny |
4.1.7 |
 Threema |
1.2.48 |
 TigerVNC |
1.15.0 |
 Todoist |
9.15.0 |
 Tofu |
3.0.1 |
 Topaz Gigapixel AI |
8.3.4 |
 Trae |
1.0.12894 |
 Transmission |
4.0.6 |
 Transmit |
5.10.8 |
 Transnomino |
9.3 |
 Tunnelblick |
8.0 |
 Twingate |
2025.138.13830 |
 Typora |
1.10.10 |
 UnnaturalScrollWheels |
1.3.0 |
 UPDF |
1.8.11 |
 Upscayl |
2.15.0 |
 UTM |
4.6.5 |
 VeraCrypt |
1.26.20 |
 Vimcal |
1.0.35 |
 VimR |
0.53.0 |
 VisualVM |
2.2 |
 Vivaldi |
7.4.3684.38 |
 Viz |
2.2.1 |
 VLC media player |
3.0.21 |
 VSCodium |
1.100.23258 |
 Wave Terminal |
0.11.3 |
 Webex Teams |
45.5.0.32411 |
 WebStorm |
2025.1.1 |
 WeChat for Mac |
4.0.3.93 |
 WhatsApp |
2.25.14.77 |
 WindowKeys |
2.0 |
 Windows App |
11.1.5 |
 Windsurf |
1.9.0 |
 WineHQ-stable |
10.0 |
 Wire |
3.40.5285 |
 Wireshark |
4.4.6 |
 Witch |
4.6.2 |
 Wondershare Filmora |
13.0.25 |
 XCA |
2.9.0 |
 XMind |
25.04.03033-202505120608 |
 Xnapper |
1.17.1 |
 Yaak |
2025.2.2 |
 Yubikey Manager |
1.2.5 |
 Zed |
0.187.4 |
 Zed Attack Proxy |
2.16.1 |
 Zen Browser |
1.12.3b |
 Zoom |
6.4.10.56141 |
Note
Missing an app? Feel free to request additional app support by creating an issue!
First decide which authentication method you would like to use. There are currently the following methods implemented:
- System Managed Identity
- User Managed Identity
- ClientSecret & ClientID using App Registration
- Certificate based authentication
- Open your Automation Account and select Account Settings -> Identity.
- Turn Status on tab "System assigned" to "On".
- Add the following API permissions to your System Managed Identity using this PowerShell script: Microsoft Tech Community
- DeviceManagementApps.ReadWrite.All
- Open Entra admin center -> Applications -> Enterprise Applications. Change Filter "Application type" to "Managed Identities" and search for your Automation Account name. Open the entity.
- Verify that the right permissions are set to the Managed Identity in the Security -> Permissions tab.
- Create a new Variable in your Automation Account with the name "AuthenticationMethod" and value "SystemManagedIdentity" to use the System Managed Identity.
- Open Azure Portal and search for "Managed Identities".
- Click "Create" and select your Azure Subscription & Resource group. Choose your region and set a name for the identity.
- Open your Automation Account and select Account Settings -> Identity.
- Switch to tab "User assigned" and click "Add". Choose the previously created Managed Identity.
- Add the following API permissions to your System Managed Identity using this PowerShell script: Microsoft Tech Community
- DeviceManagementApps.ReadWrite.All
- Open Entra admin center -> Applications -> Enterprise Applications. Change Filter "Application type" to "Managed Identities" and search for your Automation Account name. Open the entity.
- Verify that the right permissions are set to the Managed Identity in the Security -> Permissions tab.
- Create a new Variable in your Automation Account with the name "AuthenticationMethod" and value "UserAssignedManagedIdentity" to use the User Assigned Managed Identity.
- Create a new App Registration in Azure
- Add the following API permissions:
- DeviceManagementApps.ReadWrite.All
- Update the parameters in the script with your Azure details.
- $appid = '' # App ID of the App Registration
- $tenantid = '' # Tenant ID of your EntraID
- $certThumbprint = '' # Thumbprint of the certificate associated with the App Registration
- Generate a self-signed certificate:
$cert = New-SelfSignedCertificate -Subject "CN=IntuneBrew" -CertStoreLocation "Cert:\CurrentUser\My" -KeyExportPolicy Exportable -KeySpec Signature -KeyLength 2048 -KeyAlgorithm RSA -HashAlgorithm SHA256 -NotAfter (Get-Date).AddYears(2)- Export the certificate:
$pwd = ConvertTo-SecureString -String "YourPassword" -Force -AsPlainText
Export-PfxCertificate -Cert $cert -FilePath "IntuneBrew.pfx" -Password $pwd- Upload to Azure App Registration:
- Go to your App Registration in Azure Portal
- Navigate to "Certificates & secrets"
- Upload the public key portion of your certificate
Using the -CopyAssignments switch with IntuneBrew.ps1 or creating a CopyAssignments Variable with Boolean Value true in your Azure Automation indicates that assignments from the existing app version should be copied to the new version.
Apps are defined in JSON files with the following structure:
{
"name": "Application Name",
"description": "Application Description",
"version": "1.0.0",
"url": "https://download.url/app.dmg",
"bundleId": "com.example.app",
"homepage": "https://app.homepage.com",
"fileName": "app.dmg"
}IntuneBrew implements sophisticated version comparison logic:
- Handles various version formats (semantic versioning, build numbers)
- Supports complex version strings (e.g., "1.2.3,45678")
- Manages version-specific updates and rollbacks
- Provides clear version difference visualization
Version comparison rules:
- Main version numbers are compared first (1.2.3 vs 1.2.4)
- Build numbers are compared if main versions match
- Special handling for complex version strings with build identifiers
IntuneBrew includes robust error handling mechanisms:
-
Upload Retry Logic
- Automatic retry for failed uploads (up to 3 attempts)
- Exponential backoff between retries
- New SAS token generation for expired URLs
-
File Processing
- Temporary file cleanup
- Handle locked files
- Memory management for large files
-
Network Issues
- Connection timeout handling
- Bandwidth throttling
- Resume interrupted uploads
-
Authentication
- Token refresh handling
- Certificate expiration checks
- Fallback to interactive login
-
File Access Errors
- Ensure no other process is using the file
- Try deleting temporary files manually
- Restart the script
-
Upload Failures
- Check your internet connection
- Verify Azure AD permissions
- Ensure file sizes don't exceed Intune limits
-
Authentication Issues
- Verify your Azure AD credentials
- Check tenant ID configuration
- Ensure required permissions are granted
-
PowerShell 7 Command Not Found
If you're getting "IntuneBrew is not recognized as a name of a cmdlet, function, script file, or executable program" in PowerShell 7:
Step 1: Check your PATH environment variable
"Current PATH:" $env:PATH -split ';'
Step 2: Verify IntuneBrew installation location
$intuneBrewInfo = Get-InstalledScript -Name IntuneBrew -ErrorAction SilentlyContinue if ($intuneBrewInfo) { "Installed Location for IntuneBrew:" $intuneBrewInfo | Select-Object Name, Version, InstalledLocation } else { Write-Warning "IntuneBrew is not installed. Run: Install-Script IntuneBrew -Force" return }
Step 3: Add IntuneBrew to your PATH if needed
$scriptPath = $intuneBrewInfo.InstalledLocation if (-not ($env:PATH -split ';' | Where-Object { $_ -eq $scriptPath })) { Write-Host "`nπ Adding IntuneBrew script folder to PATH..." -ForegroundColor Yellow [Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$scriptPath", [EnvironmentVariableTarget]::User) Write-Host "β Done. Restart PowerShell to use 'IntuneBrew' as a command." -ForegroundColor Green } else { Write-Host "β Script path is already in PATH." -ForegroundColor Green }
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Thanks to all contributors who have helped shape IntuneBrew
- Microsoft Graph API documentation and community
- The PowerShell community for their invaluable resources
If you encounter any issues or have questions:
- Check the Issues page
- Review the troubleshooting guide
- Open a new issue if needed
Made with β€οΈ by Ugur Koc
