Skip to main content

Prerequisites

Before installing and running Intune Commander, ensure your environment meets the following requirements.

System Requirements

.NET 10 SDK

Intune Commander is built on .NET 10 and requires the SDK to build and run the application.
1

Download .NET 10 SDK

Download and install the .NET 10 SDK from the official Microsoft website:Download .NET 10 SDK
2

Verify installation

Open a terminal and verify the installation:
dotnet --version
You should see version 10.0.x or higher.

Development Environment (Optional)

While you can run Intune Commander using the .NET CLI, a development environment is helpful for building and debugging:
  • Visual Studio 2022 (Windows)
  • JetBrains Rider (Windows, macOS, Linux)
  • Visual Studio Code with C# Dev Kit extension (Windows, macOS, Linux)

Operating System Requirements

Windows 10 1809 or higher is the recommended and fully supported platform.
PlatformSupport LevelNotes
Windows✅ Fully SupportedAll features available, recommended platform
macOS⚠️ Limited SupportAvalonia limitations require Device Code authentication instead of interactive browser popup
Linux🔄 PlannedInitial support limited to headless/Core scenarios, scheduled report generation

Hardware Requirements

  • RAM: 512 MB minimum, 1 GB recommended
  • Disk Space: 200 MB for application and dependencies
  • .NET Runtime: Bundled with application (self-contained deployment)

Azure AD Requirements

App Registration

Intune Commander requires an Azure AD app registration to authenticate and access Microsoft Graph API.
You need separate app registrations for each cloud environment (Commercial, GCC-High, DoD) because these environments use different Azure portals and authentication endpoints.
Azure Portal URLs by Cloud:
Cloud EnvironmentAzure Portal URL
Commercialhttps://portal.azure.com
GCChttps://portal.azure.com
GCC-Highhttps://portal.azure.us
DoDhttps://portal.apps.mil

Redirect URI Configuration

Your app registration must include the following redirect URI:
http://localhost:45132
Platform type: Mobile and desktop applications
The redirect URI is required for interactive browser authentication. If you’re using only client secret authentication, this is not required, but interactive authentication is recommended for better security.

Microsoft Graph API Permissions

Intune Commander requires Microsoft Graph API permissions to read and manage Intune configurations.

Required Delegated Permissions

These permissions are required for the application to function:
All permissions listed below must be granted Admin Consent by a Global Administrator or Privileged Role Administrator in your tenant.

Device Management

DeviceManagementConfiguration.ReadWrite.All
DeviceManagementManagedDevices.ReadWrite.All
DeviceManagementServiceConfig.ReadWrite.All
DeviceManagementApps.ReadWrite.All
  • DeviceManagementConfiguration.ReadWrite.All: Read and write device configurations, compliance policies, settings catalog
  • DeviceManagementManagedDevices.ReadWrite.All: Read and write managed device information
  • DeviceManagementServiceConfig.ReadWrite.All: Read and write service configuration (enrollment, scope tags, roles)
  • DeviceManagementApps.ReadWrite.All: Read and write application management policies

Identity & Access

Policy.Read.All
Policy.ReadWrite.ConditionalAccess
Application.Read.All
  • Policy.Read.All: Read authentication methods, authorization policies, conditional access
  • Policy.ReadWrite.ConditionalAccess: Read and write conditional access policies
  • Application.Read.All: Read application registrations and service principals

Directory & Groups

Directory.Read.All
Group.Read.All
GroupMember.Read.All
  • Directory.Read.All: Read directory data including users, groups, and organizational information
  • Group.Read.All: Read group properties and memberships
  • GroupMember.Read.All: Read group membership information

Permission Setup Steps

1

Navigate to API permissions

In the Azure portal:
  1. Go to Azure Active DirectoryApp registrations
  2. Select your app registration
  3. Click API permissions in the left navigation
2

Add Microsoft Graph permissions

  1. Click Add a permission
  2. Select Microsoft Graph
  3. Choose Delegated permissions
  4. Search for and select each permission listed above
  5. Click Add permissions
3

Grant admin consent

  1. Click Grant admin consent for [Your Organization]
  2. Confirm by clicking Yes
  3. Wait for the status to update to “Granted”
For automated setup of app registrations with all required permissions, see the PowerShell script at scripts/Setup-IntegrationTestApp.ps1 in the source repository.

Read-Only Alternative

If you only need to view configurations without making changes, you can use read-only permissions:
DeviceManagementConfiguration.Read.All
DeviceManagementManagedDevices.Read.All
DeviceManagementServiceConfig.Read.All
DeviceManagementApps.Read.All
Policy.Read.All
Directory.Read.All
Group.Read.All
With read-only permissions, import and update operations will fail. Export functionality will continue to work.

Authentication Methods

Intune Commander supports two authentication methods:
  • User Experience: Browser popup with Azure AD sign-in
  • Token Storage: Persistent token cache per profile
  • Security: User-based authentication with MFA support
  • Use Case: Interactive desktop use, administrative tasks
Requirements:
  • Redirect URI configured: http://localhost:45132
  • Port 45132 not blocked by firewall
  • Browser available for sign-in

Client Secret

  • User Experience: Silent authentication, no browser interaction
  • Token Storage: Client secret stored encrypted locally
  • Security: Service principal authentication
  • Use Case: Automated scenarios, unattended operations, scheduled tasks
Requirements:
  • Client secret created in app registration
  • Secret value stored securely (encrypted in profile)
  • App registration has application permissions (if needed)
macOS Users: Due to Avalonia UI limitations on macOS, interactive browser authentication may not work reliably. Use Device Code authentication or Client Secret authentication instead.

Network Requirements

Firewall Rules

Ensure your firewall allows outbound HTTPS (443) connections to: Commercial & GCC:
https://login.microsoftonline.com
https://graph.microsoft.com
GCC-High:
https://login.microsoftonline.us
https://graph.microsoft.us
DoD:
https://login.microsoftonline.us
https://dod-graph.microsoft.us

Local Ports

For interactive browser authentication, port 45132 must be available on localhost for the OAuth redirect.

Optional Components

Syncfusion License (PowerPoint Export)

The Conditional Access PowerPoint export feature uses Syncfusion.Presentation.Net.Core, which requires a license key.
End users of the official release executable do not need a license key—it is embedded during the build process.
For local development or self-builds:
  1. Community License (FREE):
  2. Commercial License:
  3. Set environment variable:
    # Windows (PowerShell)
    $env:SYNCFUSION_LICENSE_KEY="your-license-key-here"
    
    # Linux/macOS
    export SYNCFUSION_LICENSE_KEY="your-license-key-here"
    
Without a license key, exported PowerPoint files will display watermarks. All other functionality remains unaffected.

Avalonia Accelerate (Optional)

Avalonia Accelerate is a community license that provides performance improvements for Avalonia UI applications. It is optional but recommended.

Next Steps

Once you’ve verified all prerequisites are met:

Installation

Build from source and run the application

App Registration

Create Azure AD app registrations for your cloud environments

Build docs developers (and LLMs) love