Introducing Intune-Toolkit

Are you finding it challenging to manage assignments on Microsoft Intune policies? Say hello to the Intune-Toolkit, your new PowerShell-powered assistant designed to make your life easier and streamline your management tasks.

Why Intune-Toolkit

Existing tools might help you deploy Intune policies, but they often fall short when it comes to bulk assignments. Typically, you have to manually assign each policy after deployment, which can be tedious and prone to errors. It’s easy to miss a policy, only to discover the oversight weeks later. The Intune-Toolkit simplifies this process, ensuring you can handle bulk assignments effortlessly

Overview

The Intune-Toolkit offers a basic & user-friendly interface to connect to Microsoft Graph, manage policy assignments, and handle backup and restore operations.

Key Features

  • Connect to Microsoft Graph: Authenticate with necessary scopes.
  • Tenant Information: Display tenant details and signed-in user information.
  • Policy and App Management: View and manage policies and apps with their assignments.
  • Supported Assignments:
    • Configuration Policies
    • Device Configuration Policies
    • Device Compliance Policies
    • Mobile Applications (Windows & Mac OS)
    • App Configuration Policies
    • Administrative Templates
    • Platform Scripts
    • Mac OS Scripts
  • Assignment Management:
    • Add and delete assignments for selected policies.
    • Search Security Groups.
    • Support for filters and installation intent.
  • Backup and Restore:
    • Back up and restore assignments to policies and apps.
  • Export Assignments:
    • Export assignments to CSV
    • Document Assignments to Markdown File
      • Selected Policies / applications
      • Bulk Export of Policy Type
  • Logging: Detailed logging for all major actions and error handling.

Prerequisites

To use the Intune Toolkit, ensure you have the following:

  • PowerShell 7.0 or later.
  • Microsoft Graph PowerShell SDK.
  • Windows Presentation Framework (WPF) for the GUI components.
  • Access to Microsoft Intune with the necessary permissions.

MS Graph Api permission scope

  • User.Read.All
  • Directory.Read.All
  • DeviceManagementConfiguration.ReadWrite.All
  • DeviceManagementApps.ReadWrite.All

Installation

Getting started with the Intune Toolkit is a breeze! You can either clone the repository or download it directly from GitHub.

  1. Clone the repository:git clone https://github.com/MG-Cloudflow/Intune-Toolkit cd Intune-Toolkit
  2. Download from GitHub: Simply download the toolkit from GitHub and unzip it to your desired location.
  3. Install the Microsoft Graph PowerShell SDK:Install-Module Microsoft.Graph -Scope CurrentUser
  4. Ensure necessary assemblies and permissions to run the toolkit.

Usage

Using the Intune Toolkit is super simple and user-friendly. Hereā€™s how you can get started:

  • Launch the Main Script:.\Main.ps1
  • Connect to Microsoft Graph:
    • Click the “Connect” button to sign in and authorize the toolkit.
  • Manage Policies:
    • Select the type of policy to manage using the corresponding buttons.
    • View and manage the assignments for the selected policies.
  • Backup Policies:
    • Click the “Backup” button to save current assignments to a JSON file.
  • Restore Policies:
    • Click the “Restore” button to load assignments from a backup file.
  • Add/Remove Assignments:
    • Use the “Add Assignment” and “Delete Assignment” buttons to manage assignments.
  • Documentation Markdown
    • When you dont select policies / apps it will document the full set of policy’s displayed in the grid.
    • when selecting policy it will only document the assignment of the selected policy

Alpha Version and Your Input

The Intune-Toolkit is currently in its alpha version, and Iā€™m eager to get your feedback. If you encounter any bugs or have suggestions for improvements, please let me know on GitHub. If you’re interested in contributing to the project, let’s connect and collaborate to make this toolkit even better.

Ready to make your Intune policy management more efficient? Try the Intune-Toolkit today!

Known Issues

  • Assign to all devices
  • Assign to MacOS Apps

Release Notes

v0.2.7-alpha

  • Code Optimization
    • Assignments
      • Refactored assignment logic by splitting the assignment button handling into a separate function file for better maintainability and clarity.
      • Prepared the structure to support new application types in future releases.
    • Graph Module
      • Optimized module installations to include only the essential Graph module:Ā Microsoft.Graph.Authentication.
      • Added a confirmation popup that prompts users before installing any required modules, improving user control over the installation process.

v0.2.6-alpha

  • Features
    • Editing Policy Names
    • Editing Policy Description
    • Implementing Connect-ToMgGraph -> Created By thiago beier https://github.com/thiagogbeier/Connect-To-MgGraph
      • Implemented Intune Toolkit Logging
      • Optimizing Ms Graph Module Detection & Installation
      • Implemented Interactive Logon
      • Implemented App Registration Logon
  • BugFix
    • Fixed issue with assignments of Microsoft Store app (new) => Issue #25
  • Other
    • Added A CODE OF CONDUCT
    • Added CONTRIBUTION GUIDELINES
    • Split up Release notes from ReadMe File

v0.2.5-alpha

  • Performance Upgrades
    • Enhanced performance of security group fetching by adding additional filters to Graph API calls, reducing load times.
    • Introduced a manual sync button for on-demand updates of security groups.
    • Removed automatic security group fetching when loading policies/applications to prevent delays in large tenants.
      • Security groups are now loaded at startup or through manual refresh.

v0.2.4-alpha

  • BugFix
    • moved powershell validation to before check microsoft.graph module -> contribution By thiago beier

v0.2.3-alpha

  • Features
    • added log file to $env: as %temp% location under current user context/scope -> contribution By thiago beier
    • added the powershell 7.0.0 as minimum requirement as per in documentation validation with end-user notification to upgrade or open powershell 7.x -> contribution By thiagogbeier

v0.2.2-alpha

  • Features
    • Assignments
      • Managed Google Play Store App
      • IOS Store App
    • Platform Inormation
    • Update to “Export to Mark Down (MD)”
      • Table of Contents
      • Platform Information

v0.2.1-alpha

  • Bug Fixes
    • Assignment Issue with Device confiuration poilicy (Settings Catalog)

v0.2.0-alpha

  • Features
    • Mac OS Scripts
    • App Configuration Policies
    • Document To markdown
      • Selected Policies / applications
      • Bulk Export of Policy Type
    • Basic Version Check to latest Release Version on Github
  • Bug Fixes
    • Build in safety when no filters Exists ( Second Attempt šŸ˜‰ )

Documentation Example

v0.1.1-alpha

  • Features
    • Platform scripts
    • Export assignments to csv
  • UI
    • Updated UI
    • Remove install intent column in policy Context
  • Bug Fixes 
    • Build in safety when no filters Exists
    • Checks for MS Graph Module

Leave a Reply

Your email address will not be published. Required fields are marked *