https://github.com/byteben/Win32App-Migration-Tool

Last synced: 5 days ago
JSON representation

Host: GitHub
URL: https://github.com/byteben/Win32App-Migration-Tool
Owner: byteben
License: gpl-3.0
Created: 2021-03-19T13:27:27.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2024-06-09T15:58:55.000Z (10 months ago)
Last Synced: 2024-08-02T17:33:05.154Z (9 months ago)
Language: PowerShell
Size: 261 KB
Stars: 78
Watchers: 19
Forks: 19
Open Issues: 1
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

jimsghstars - byteben/Win32App-Migration-Tool - (PowerShell)

README

# Win32 App Migration Tool
![PowerShell Gallery](https://img.shields.io/powershellgallery/dt/Win32AppMigrationTool?color=green&label=PowerShell%20Gallery%20Downloads&logo=powershell)
![License: Non-Commercial](https://img.shields.io/badge/License-Non--Commercial-purple.svg)
![PowerShell](https://img.shields.io/badge/PowerShell-v7%2B-yellow?logo=powershell)
![PowerShell](https://img.shields.io/badge/PowerShell-v5.1-blue?logo=powershell)

![Tool Preview](https://byteben.com/bb/Downloads/GitHub/MigTool3-AppSelection.jpg)

---

## 📝 Synopsis

The **Win32AppMigrationTool** is designed to inventory **ConfigMgr Applications** and Deployment Types, build .intunewin files, and create win32 apps in the Intune.

---

## 🔐 License

- **Non-Commercial Use**: This software is provided for non-commercial use only. Commercial use is prohibited without prior written consent from the author.

- **Modifications**: You are permitted to modify or fork the code for personal use only. However, you may not distribute the original or modified versions of the code, share it to add additional functionality, or incorporate it into commercial products.

This project is licensed under the [Non-Commercial License](License). You may not reproduce, distribute, or use any part of this code for commercial purposes. For detailed terms and conditions, please refer to the [License](License) file in this directory.

---

## ⚖️ Legal Disclaimer

The provided PowerShell script is shared with the community as-is. The author and any co-author(s) make no warranties or guarantees regarding its functionality, reliability, or suitability for any specific purpose.

This script may require modifications to fit your specific environment or requirements. It is strongly recommended to test the script in a non-production environment before using it in a live or critical system.

The author and co-author(s) shall not be held responsible for any damages, losses, or unintended effects resulting from the use of this script. By using this script, you assume all associated risks and responsibilities.

---

## 👩‍💻 Development Status

**STATUS: Preview**
The Win32App Migration Tool is in Preview.

## 📋 Requirements

- **Configuration Manager Console** The console must be installed on the machine you are running the Win32App Migration Tool from. The following path should resolve true: $ENV:SMS_ADMIN_UI_PATH
- **Local Administrator** The default Working folder is $ENV:SystemDrive\Win32AppMigrationTool. You will need permissions to create this directory on the System Drive
- **Roles** Permission to run the Configuration Manager cmdlet **Get-CMApplication**
- **Content Folder Permission** Read permissions to the content source for the Deployment Types that will be exported
- **PowerShell 5.1** PowerShell 7 is recommended to ensure Blob files are verificed after chunking to Azure Storage and to correctly analyzing certain ConfigMgr detection types
- **Internet Access** to download the Win32 Content Prep Tool
- **Microsoft.Graph.Authentication Module** Install-Module -Name Microsoft.Graph.Authentication (This is installed as part of the Win32AppMigrationTool Module if the -CreateApps parameter is passed)
- **Az.Storage Module** Install-Module -Name Az.Storage (This is installed as part of the Win32AppMigrationTool Module if the -CreateApps parameter is passed)
- **Entra ID App Registration** The Client App must have a redirect URI configured for **http://localhost**. This is required for `Connect-MgGraph` to work correctly

## 👏 Quick Start

**1. Install-Module Win32AppMigrationTool**
**2. New-Win32App** -ProviderMachineName "SCCM1.byteben.com" -AppName "Microsoft Edge Chromium *"
**3. Use Information from the CSVs to build a Win32 app in Intune**

```
New-Win32App -ProviderMachineName -AppName
```

## 🔢 Order of Operations

The current release of the Win32 App Migration Tool will do the following:-

- Download the Win32 app Content Prep Tool to %WorkingDirectory%\ContentPrepTool
- Export .intunewin files to %WorkingDirectory%\Win32Apps\\
- Export Application Details to %WorkingDirectory%\Details\Applications.csv
- Export Deployment Type Details to %WorkingDirectory%\Details\DeploymentTypes.csv
- Export Content Details to %WorkingDirectory%\Details\Content.csv (If -DownloadContent parameter passed)
- Copy Select Deployment Type Content to %WorkingDirectory%\Content\
- Export Application icons(s) to %WorkingDirectory%\Icons
- Build Win32 app JSON payload body for Intune
- Convert detection to JSON for Intune
- Extract the IntunePackage.intunewin for upload
- Get encryption information for Intunewin
- Request Content Upload Uri from Intune
- Upload file in chunks to Intune
- Commit file to Intune
- Log events to %WorkingDirectory%\Logs\Main.log

### 1. Environment Setup

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool1-Env.jpg)

### 2. Authentication

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool2-Authentication.jpg)

### 3. Application Selection

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool3-AppSelection.jpg)

### 4. Application Details Export

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool4-AppDetails.jpg)

### 5. Deployment Type Details Export

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool5-DeploymentTypeDetails.jpg)

### 6. Content Details Export

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool6-ContentDetails.jpg)

### 7. Content Download

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool7-ContentCopy.jpg)

### 8. CSV Export of Application Details

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool8-CSVExport.jpg)

### 9. Icon Export

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool9-IconExport.jpg)

### 10. Create an Intunewin

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool10-CreateIntunewinjpg.jpg)

### 11. Create Win32App JSON Body

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool11-CreateWin32AppJson.jpg)

### 12. Create the WIn32 app in Intune

![alt text](https://byteben.com/bb/Downloads/GitHub/MigTool12-CreateWin32App.jpg)

## ⚠️ Important Information

_**// Please use the tool with caution and test in your lab (dont be the person who tests in production). I accept no responsibility for loss or damage as a result of using these scripts //**_

## Troubleshooting

**Main.log** in the **%WorkingFolder%\Logs** folder contains a detailed verbose output of the solution

![alt text](https://byteben.com/bb/Downloads/GitHub/Main-Log.jpg)

## ↘️ Parameters

### -SiteCode

The Site Code of the ConfigMgr Site. The Site Code must be only 3 alphanumeric characters. This is an optional parameter. If not passed, the script will attempt to get the Site Code automatically from WMI. If the Site Code cannot be determined, the script will exit with an error message after 3 invalid attempts.

```yaml
Type: String
Parameter Sets: (All)

Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Validate Pattern: ^[a-zA-Z0-9]{3}$')]
```

### -ProviderMachineName

Server name that has an SMS Provider site system role

```yaml
Type: String
Parameter Sets: (All)

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Parameter AppName

Pass an app name to search for matching applications in ConfigMgr. You can use * as a wildcard e.g. "Microsoft*" or "\*Reader"

```yaml
Type: String
Parameter Sets: (All)

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
```

### -Parameter WorkingFolder

The working folder for the Win32AppMigration Tool. Care should be given when specifying the working folder because downloaded content can increase the working folder size considerably

```yaml
Type: String
Parameter Sets: (All)

Required: False
Position: 3
Default value: C:\Win32AppMigrationTool
Accept pipeline input: False
Accept wildcard characters: False
```

### -Parameter ExcludeFilter

Pass this parameter to exclude specific apps from the results. Accepts wildcards e.g. "Microsoft*"'

```yaml
Type: String
Parameter Sets: (All)

Required: False
Position: 4
Default value:
Accept pipeline input: False
Accept wildcard characters: True
```

### -Parameter Win32ContentPrepToolUri

URI for Win32 Content Prep Tool

```yaml
Type: String
Parameter Sets: (All)

Required: False
Position: 5
Default value: https://github.com/microsoft/Microsoft-Win32-Content-Prep-Tool/raw/master/IntuneWinAppUtil.exe
Accept pipeline input: False
Accept wildcard characters: False
```

### -Parameter OverrideIntuneWin32FileName

Override intunewin filename. Default is the name calcualted from the install command line

```yaml
Type: String
Parameter Sets: (All)

Required: False
Position: 6
Default value:
Accept pipeline input: False
Accept wildcard characters: False
```

### -Parameter DownloadContent

DownloadContent: When passed, the content for the deployment type is saved locally to the working folder "Content"

```yaml
Type: Switch
Parameter Sets: (All)