🍺 IntuneBrew

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, complete with proper metadata and logos.

📚 Table of Contents

• 📚 Table of Contents
• 🚨 Public Preview Notice
• ✨ Features
• 🎬 Demo
• 🚀 Getting Started
  • Prerequisites
  • Installation
• 📝 Usage
  • Basic Usage
  • 📱 Supported Applications
• 🔧 Configuration
  • Azure App Registration
• 🤔 Troubleshooting
  • Common Issues
• 🤝 Contributing
• 📜 License
• 🙏 Acknowledgments
• 📞 Support

🚨 Public Preview Notice

[!IMPORTANT] 🚧 Public Preview Notice

IntuneBrew is currently in Public Preview. While it's fully functional, you might encounter some rough edges. Your feedback and contributions are crucial in making this tool better!

• 📝 Submit Feedback
• 🐛 Report Bugs
• 💡 Request Features

Thank you for being an early adopter! 🙏

🔄 Latest Updates

Last checked: 2024-11-26 00:16 UTC

✨ Features

• 🚀 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

🎬 Demo

🚀 Getting Started

Prerequisites

• PowerShell 7.0 or higher
• Microsoft Graph PowerShell SDK
• Azure App Registration with appropriate permissions OR Manual Connection via Interactive Sign-In
• Windows or macOS operating system

Installation

1. Clone the repository:
2. Install required PowerShell modules:

Install-Module Microsoft.Graph.Authentication -Scope CurrentUser

3. Configure your environment variables or update the config file with your Azure AD details.

📝 Usage

Basic Usage

.\IntuneBrew.ps1

Follow the interactive prompts to:

1. Select which apps to upload
2. Authenticate with Microsoft Graph
3. Monitor the upload progress
4. View the results in Intune

📱 Supported Applications

Application	Latest Version
Adobe Acrobat Pro DC	24.004.20272
Adobe Acrobat Reader	24.004.20219
Adobe Creative Cloud	6.4.0.361
Android Studio	2024.2.1.11
AnyDesk	8.1.4
Asana	1.0
Bitwarden	2024.11.2
Blender	4.3.0
Brave	1.73.91.0
Canva	1.97.0
Company Portal	5.2409.1
DeepL	1.0
Docker Desktop	4.36.0,175267
Dropbox	212.4.5767
Evernote	10.105.4,20240910164757,a2e60a8d876a07eded5d212fa56ba45214114ad0
Google Chrome	131.0.6778.86
Grammarly Desktop	1.96.0.0
KeePassXC	2.7.9
Krisp	2.46.11
Microsoft Teams	24295.606.3238.6194
Miro	0.9.78
MongoDB Compass	1.44.7
Mozilla Firefox	132.0.2
Notion	4.0.0
Obsidian	1.7.7
Parallels Desktop	20.1.1-55740
Real VNC Viewer	7.13.0
Remote Help	1.0.2404171
RStudio	2024.09.1,394
Signal	7.34.0
Slack	4.41.98
Snagit	2024.4.0
Spotify	1.2.51.345
Suspicious Package	4.5,1213
Synology Drive	3.5.1,16102
Tableau Desktop	2024.2.4
TeamViewer QuickSupport	15
Todoist	9.9.3
UTM	4.5.4
VLC media player	3.0.21
Webex Teams	44.11.1.31236
Windows App	11.0.7
XMind	24.10.01101-202410201844
Zoom	6.2.10.43047

[!NOTE] Missing an app? Feel free to request additional app support by creating an issue!

🔧 Configuration

Azure App Registration

1. Create a new App Registration in Azure
2. Add the following API permissions:
   • DeviceManagementApps.ReadWrite.All
3. 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

🤔 Troubleshooting

Common Issues

1. File Access Errors

   • Ensure no other process is using the file
   • Try deleting temporary files manually
   • Restart the script

2. Upload Failures

   • Check your internet connection
   • Verify Azure AD permissions
   • Ensure file sizes don't exceed Intune limits

3. Authentication Issues

   • Verify your Azure AD credentials
   • Check tenant ID configuration
   • Ensure required permissions are granted

🤝 Contributing

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.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Thanks to all contributors who have helped shape IntuneBrew
• Microsoft Graph API documentation and community
• The PowerShell community for their invaluable resources

📞 Support

If you encounter any issues or have questions:

1. Check the Issues page
2. Review the troubleshooting guide
3. Open a new issue if needed

Made with ❤️ by Ugur Koc