Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/ugurkocde/IntuneBrew

Last synced: 7 days ago
JSON representation
Host: GitHub
URL: https://github.com/ugurkocde/IntuneBrew
Owner: ugurkocde
License: mit
Created: 2024-10-22T07:50:50.000Z (23 days ago)
Default Branch: main
Last Pushed: 2024-10-25T00:15:15.000Z (20 days ago)
Last Synced: 2024-10-25T05:12:54.318Z (20 days ago)
Language: PowerShell
Homepage: https://IntuneMacAdmins.com
Size: 27.9 MB
Stars: 10
Watchers: 3
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- Funding: funding.yml
- License: LICENSE
- Support: supported_apps.json
Awesome Lists containing this project

README

        ![IntuneBrew_Header](https://github.com/user-attachments/assets/c036ff17-ecad-4615-a7b5-6ffbd3d4ebf1)

🍺 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](#-table-of-contents)

- [🚨 Public Preview Notice](#-public-preview-notice)

- [✨ Features](#-features)

- [🎬 Demo](#-demo)

- [🚀 Getting Started](#-getting-started)

  - [Prerequisites](#prerequisites)

  - [Installation](#installation)

- [📝 Usage](#-usage)

  - [Basic Usage](#basic-usage)

  - [📱 Supported Applications](#-supported-applications)

- [🔧 Configuration](#-configuration)

  - [Azure App Registration](#azure-app-registration)

- [🤔 Troubleshooting](#-troubleshooting)

  - [Common Issues](#common-issues)

- [🤝 Contributing](#-contributing)

- [📜 License](#-license)

- [🙏 Acknowledgments](#-acknowledgments)

- [📞 Support](#-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](https://github.com/ugurkocde/IntuneBrew/issues/new?labels=feedback)

> - 🐛 [Report Bugs](https://github.com/ugurkocde/IntuneBrew/issues/new?labels=bug)

> - 💡 [Request Features](https://github.com/ugurkocde/IntuneBrew/issues/new?labels=enhancement)

>

> Thank you for being an early adopter! 🙏

## 🔄 Latest Updates

*Last checked: 2024-11-07 00:15 UTC*

| Application | Previous Version | New Version |

|-------------|-----------------|-------------|

| Google Chrome | 130.0.6723.92 | 130.0.6723.117 |

| Grammarly Desktop | 1.94.0.0 | 1.94.1.0 |

| Webex Teams | 44.10.1.31028 | 44.11.0.31172 |

| Adobe Acrobat Pro DC | 24.004.20219 | 24.004.20243 |

| Brave | 1.71.121.0 | 1.71.123.0 |

| Tableau Desktop | 2024.2.3 | 2024.2.4 |

## ✨ 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

![IntuneBrew Demo](IntuneBrew_Demo.gif)

## 🚀 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:

```powershell

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

```powershell

.\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.20243 |

|  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.10.2 |

|  Blender | 4.2.3 |

|  Brave | 1.71.123.0 |

|  Canva | 1.97.0 |

|  Company Portal | 5.2409.1 |

|  DeepL | 1.0 |

|  Docker Desktop | 4.35.1,173168 |

|  Dropbox | 211.4.6008 |

|  Evernote | 10.105.4,20240910164757,a2e60a8d876a07eded5d212fa56ba45214114ad0 |

|  Google Chrome | 130.0.6723.117 |

|  Grammarly Desktop | 1.94.1.0 |

|  KeePassXC | 2.7.9 |

|  Krisp | 2.46.11 |

|  Microsoft Teams | 24277.3502.3161.3007 |

|  Miro | 0.8.74 |

|  MongoDB Compass | 1.44.6 |

|  Mozilla Firefox | 132.0.1 |

|  Notion | 3.18.0 |

|  Obsidian | 1.7.5 |

|  Parallels Desktop | 20.1.1-55740 |

|  Real VNC Viewer | 7.12.1 |

|  Remote Help | 1.0.2404171 |

|  RStudio | 2024.09.1,394 |

|  Signal | 7.31.0 |

|  Slack | 4.41.97 |

|  Snagit | 2024.3.2 |

|  Spotify | 1.2.49.439 |

|  Suspicious Package | 4.5,1213 |

|  Synology Drive | 3.5.1,16102 |

|  Tableau Desktop | 2024.2.4 |

|  TeamViewer QuickSupport | 15 |

|  Todoist | 9.9.0 |

|  UTM | 4.5.4 |

|  VLC media player | 3.0.21 |

|  Webex Teams | 44.11.0.31172 |

|  Windows App | 11.0.6 |

|  XMind | 24.10.01101-202410201844 |

|  Zoom | 6.2.6.41824 |

> [!NOTE]

> Missing an app? Feel free to [request additional app support](https://github.com/ugurkocde/IntuneBrew/issues/new?labels=app-request) 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](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](https://github.com/ugurkocde/IntuneBrew/issues) page

2. Review the troubleshooting guide

3. Open a new issue if needed

---

Made with ❤️ by [Ugur Koc](https://github.com/ugurkocde)