Basic Setup

Installation

1. Download the latest MSI file from:
   Releases · rink-turksma/IntunePrepTool

2. Unblock the installer (if necessary):

   • Right-click the downloaded .msi file and select Properties.

   • If you see an “Unblock” checkbox, check it and click Apply.

3. Install the tool:

   • Double-click the .msi file to begin installation.

   • Click Yes on any security prompt.

4. After installation, IntunePrepTool will be available in the Start Menu.

• Running the Tool

  • Always run the tool as Administrator:

    • Right-click the IntunePrepTool shortcut.

    • Select Run as administrator.

      

      • If you receive this pop-up message, click Yes.

      • Wait a few seconds, then run IntunePrepTool again as Administrator.

• You might see one of the pop-ups shown below. Please click OK. After loading, you will have access to the buttons to install the required components.

• Installing Required Components

  If needed, install the prerequisites by clicking the appropriate buttons in the app:

  • Install required PowerShell modules (PowerShell_ISE)

  • Install / Update Winget (PowerShell_ISE)

  • Install Chocolatey (PowerShell_ISE)

  • Install Orca (PowerShell_ISE)

  

• 

  When you click an Install button, PowerShell ISE will open.

  • Click Run in PowerShell ISE to start the installation.

  • When the installation finishes, reopen IntunePrepTool as Administrator.

Customer setup

• Click New / Clear to create a new Customer profile.
• 

  • Fill out the form. Please follow these rules:

    • No spaces allowed in any of the fields.

    • Use a valid path for the Log Folder Target, for example:
      C:\ProgramData\CustomerName\Logs

    • Set the following folder paths:

      • Package Folder – Local path to save created packages.

      • Download Folder – Location for optional Winget downloads.

      • Building Blocks Folder – Where Building Blocks and their packages are stored.

  • Click Save when done.

Tenant setup (App Registrations)

Go to the Tenant (App Registrations) tab.

• • Click Add Tenant.

  • Fill in the following fields (no spaces allowed):

    • Tenant Name

    • App Registration Name

  • Click Add Tenant (With App Registration).

A message will appear:
“Please log in to the tenant with Global Admin rights. The app registration will be added. Please wait a few seconds!”

Note: Global Admin rights are required to automatically grant consent for the necessary API permissions in Entra ID. Only the required permissions will be applied.

 

• Click OK when the “All Done.” pop-up appears.

• Within a few seconds to two minutes, a “Sign in to your Microsoft account” pop-up will appear.

• Log in to your tenant.

Click OK when the “All Done.” pop-up appears.

Setup Azure OpenAI (Optional)

• Go to the Azure OpenAI tab.
  Click the Setup Info button to view a PDF file with setup instructions.